Skip to content

codebrick-corp/aws-dms-task-exporter

Repository files navigation

aws-dms-task-exporter

GitHub go.mod Go version of a Go module Image Build CI Go Report Card GitHub release

This is a simple service to scrape the AWS DMS Task, especially for DMS Table Statistics. The exporter exports Prometheus metrics via HTTP. It could help you to monitor detailed metrics about AWS DMS tasks.

Installation

Helm

Please check values.yaml file and override values according to your demand.

# using helm v3
helm install aws-dms-task-exporter install/charts

Docker

docker run -d \
 -p 8080:8080 \
 -e AWS_ACCESS_KEY_ID='YOUR AWS KEY ID' \
 -e AWS_SECRET_ACCESS_KEY='YOUR AWS SECRET ACCESS KEY' \
 ghcr.io/codebrick-corp/aws-dms-task-exporter:1.1.0

Local

# Build aws-dms-task-exporter
go mod tidy && go build .

# Set environments for AWS credentials
expose AWS_ACCESS_KEY_ID='YOUR AWS KEY ID'
expose AWS_SECRET_ACCESS_KEY='YOUR AWS SECRET ACCESS KEY'

# Run an exporter
./aws-dms-task-exporter 

Metrics

Below is the list of metrics that aws-dms-task-exporter exports.

Sample metrics

# TYPE dms_task_stats gauge
dms_task_stats{action="delete",region="ap-southeast-1",identifier="inventory-change-task",schema="example_schema",table="inventories"} 40601
dms_task_stats{action="insert",region="ap-southeast-1",identifier="inventory-change-task",schema="example_schema",table="inventories"} 4.145428e+06
dms_task_stats{action="update",region="ap-southeast-1",identifier="inventory-change-task",schema="example_schema",table="inventories"} 1.24051e+06
Name Description Labels
dms_task_stats DMS Task Table Statistics showing counts of Insert, Delete, Update of source tables action, region, schema, table, identifier