aws-cloudwatch

Put custom metric data to CloudWatch

$ aws cloudwatch put-metric-data --namespace [MyApp] --metric-name [RequestCount] --value [1] --unit Count

$ aws cloudwatch get-metric-statistics --namespace AWS/EC2 --metric-name CPUUtilization --dimensions Name=InstanceId,Value=[i-1234567890abcdef0] --start-time [2024-01-01T00:00:00Z] --end-time [2024-01-02T00:00:00Z] --period 3600 --statistics Average

$ aws cloudwatch put-metric-alarm --alarm-name [high-cpu] --metric-name CPUUtilization --namespace AWS/EC2 --statistic Average --period 300 --threshold 80 --comparison-operator GreaterThanThreshold --evaluation-periods 2 --dimensions Name=InstanceId,Value=[i-1234567890abcdef0]

$ aws cloudwatch describe-alarms

$ aws cloudwatch list-metrics --namespace [AWS/EC2]

$ aws cloudwatch get-metric-data --metric-data-queries '[{"Id":"m1","MetricStat":{"Metric":{"Namespace":"AWS/EC2","MetricName":"CPUUtilization"},"Period":300,"Stat":"Average"}}]' --start-time [2024-01-01T00:00:00Z] --end-time [2024-01-02T00:00:00Z]

aws cloudwatch command [options]

aws cloudwatch is the AWS CLI interface for Amazon CloudWatch, a monitoring and observability service for AWS resources and applications. CloudWatch collects metrics, logs, and events, providing visibility into resource utilization, application performance, and operational health.
CloudWatch enables setting alarms that trigger notifications or automated actions based on metric thresholds. It supports both built-in AWS service metrics and custom application metrics.

put-metric-data

Publish custom metric data points

Retrieve metric values using queries

Get statistics for a specific metric

List available metrics by namespace

Create or update a metric alarm

List configured alarms and their states

Manually set alarm state for testing

Create or update a CloudWatch dashboard

Create an anomaly detection model for a metric

Metric data older than 15 months is automatically deleted. High-resolution metrics (1-second granularity) incur additional costs. Custom metrics are charged per metric per month. Alarm evaluations may be delayed during service disruptions.

Amazon CloudWatch launched in May 2009 alongside EC2 monitoring. Custom metrics were added in 2011, dashboards in 2015, and anomaly detection in 2019. The service has evolved to become the central monitoring hub for all AWS services and is now integrated with CloudWatch Logs and EventBridge.

aws(1), aws-logs(1), aws-events(1), aws-ec2(1)