Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

AWS Health Monitoring default checks and policies

Agent Client Collector provides the following default checks and policies for AWS monitoring.

TypeCheckDescriptionUsageUsage example
Metricaws.metrics-ec2Returns metrics of all EC2 instances in a AWS Datacenter.metrics-ec2.rb \(options\) -F, --filter FILTER String representation of the filter to filter EC2 instances by tags. -b, --batch\_size BATCH\_SIZE Batch size. Number of instances to fetch metrics in parallel. \(Default value: 10\)

./metrics-ec2.rb -F "{name:tag:environment,values:[ENV1,ENV2]} {name:tag:Name,values:[Instance1,Instance2]}"

Provide the filter string along with double quotes ("") around the filter parameter.

Set the batch_size parameter according to the agent environment.

Metricaws.metrics-ebsReturns metrics of all EBS volumes in an AWS datacenter.metrics-ebs.rb \(options\) -F, --filter FILTER String representation of the filter to filter EBS Volumes by Tags. -b, --batch\_size BATCH\_SIZE Batch size. Number of volumes to fetch metrics parallelly. \(Default value: 10\)

./metrics-ebs.rb -F "{name:tag:environment,values:[ENV1,ENV2]} {name:tag:Name,values:[Volume1,Volume2]}"

Provide filter string along with double quotes ("") for the filter parameter.

Set the batch_size parameter according to the agent environment.

Metricaws.metrics-s3Returns metrics of all S3 buckets in an AWS datacenter.metrics-s3.rb \(options\) -b, --batch\_size BATCH\_SIZE Batch size. Number of S3 buckets to fetch metrics in parallel. \(Default value: 10\)

./metrics-s3.rb -b 5

Set the batch_size parameter according to the agent environment.

Metricaws.metrics-rdsReturns metrics of all RDS buckets in an AWS datacenter.metrics-rds.rb \(options\) -F, --filter FILTER String representation of the filter to filter RDS Instances by tags. -b, --batch\_size BATCH\_SIZE Batch size. Number of databases to fetch metrics in parallel. \(Default value: 10\)

./metrics-rds.rb -F "{name:tag:environment,values:[ENV1,ENV2]} {name:tag:engine,values:[MariaDB]}" Provide the filter string with double quotes ("") around the filter parameter.

Set the batch_size parameter according to the agent environment.

Metricaws.metrics-classic-elbReturns metrics of all classic elastic load balancers in an AWS datacenter.metrics-elb.rb \(options\) -e, --exclude\_lb EXCLUDE\_LB Exclude metrics from load balancers whose name contains one of the comma separated strings. -b, --batch\_size BATCH\_SIZE Batch size. Number of databases to fetch metrics in parallel. \(Default value: 10\)

./metrics-elb.rb -t classic -e "classic,itom,ip" -b 10

Provide comma separated strings in double quotes ("") for the exclude_lb parameter.

Set the batch_size parameter according to the agent environment.

Metricaws.metrics-network-elbReturns metrics of all network elastic load balancers in an AWS datacenter.metrics-elb.rb \(options\) -e, --exclude\_lb EXCLUDE\_LB Exclude metrics from load balancers whose name contains any of the comma separated strings. -b, --batch\_size BATCH\_SIZE Batch size. Number of databases to fetch metrics in parallel. \(Default value: 10\)

./metrics-elb.rb -t network -e "vpc,itom,ip" -b 10

Provide comma separated strings in double quotes ("") for the exclude_lb parameter.

Set the batch_size parameter according to the agent environment.

Do not change the command prefix.

Metricaws.metrics-application-elbReturns metrics of all application elastic load balancers in an AWS datacenter.metrics-elb.rb \(options\) -e, --exclude\_lb EXCLUDE\_LB Exclude metrics from load balancers whose name contains any one of the string from comma separated strings. -b, --batch\_size BATCH\_SIZE Batch size. Number of databases to fetch metrics in parallel. \(Default value: 10\)

./metrics-elb.rb -t application -e "classic,app,ip" -b 10

Provide comma separated strings in double quotes ("") for the exclude_lb parameter.

Set the batch_size parameter according to the agent environment.

Do not change the command prefix.

Metricaws.metrics-ec2-countReturns count of EC2 instances by instance\_type or status in an AWS datacenter.metrics-ec2-count.rb \(options\) -s, --scheme SCHEME Metric naming scheme, text to prepend to metric. Default: aws.ec2 -t, --type METRIC type Count by type: status, instance. Default: instance`./metrics-ec2-count.rb -t status` `./metrics-ec2-count.rb -t status -s metric.aws.ec2`
TypeCheckDescriptionUsageCommand
Metricaws.metrics-dynamodbMonitors the health of DynamoDB tables in an AWS datacenter.Binds to the DynamoDB table \(cmdb\_ci\_dynamodb\_table\)e, --exclude\_tb EXCLUDE\_TB Exclude metrics from tables whose name contains a string from comma separated strings. b, --batch\_size BATCH\_SIZE Batch size. Number of tables to fetch metrics in parallel. \(Default value: 10\)`metrics-dynamodb.rb -r {{.labels.params_ci_region}} {{.labels.params_exclude_tb}} -f {{.labels.params_exclude_tb}} {{end}} {{.labels.params_batch_size}} -b {{.labels.params_filter}} {{end}}`
TypeCheckDescriptionUsageCommand
Metricaws.metrics-ecs-clusterMonitors ECS clusters in an AWS datacenter.Binds to the AWS ECS Cluster CI type \(cmdb\_ci\_cloud\_ecs\_cluster\)-F, --filter FILTER String representation of the filter to filter ECS clusters by tags.b, --batch\_size BATCH\_SIZE Batch size. Number of clusters to fetch metrics in parallel. \(Default value: 10\)`metrics-ecs-cluster.rb -r {{.labels.params_ci_region}} {{.labels.params_filter}} -f {{.labels.params_filter}} {{end}} {{.labels.params_batch_size}} -b {{.labels.params_filter}} {{end}}`
Metricaws.metrics-ecs-serviceMonitors ECS services in an AWS datacenter.Binds to the AWS ECS Service CI type \(cmdb\_ci\_cloud\_ecs\_service\)-F, --filter FILTER String representation of the filter to filter ECS clusters by tags.b, --batch\_size BATCH\_SIZE Batch size. Number of clusters to fetch metrics in parallel. \(Default value: 10\)`metrics-ecs-service.rb -r {{.labels.params_ci_region}} {{.labels.params_filter}} -f {{.labels.params_filter}} {{end}} {{.labels.params_batch_size}} -b {{.labels.params_filter}} {{end}}`

Parent Topic:Agent Client Collector Monitoring default checks and policies

Related topics

AWS metrics