About This SampleThese scripts are designed for you to run on your Amazon EC2 instances running Linux, where you can configure them to report memory and disk space usage metrics to Amazon CloudWatch. Once the metrics are submitted to CloudWatch, you can view graphs, calculate statistics and set alarms on them in the CloudWatch console. Metrics submitted to CloudWatch from the scripts can be configured for an individual instance or across multiple instances. Additionally, Amazon Auto Scaling customers can use the metrics reported by the scripts for Auto Scaling policies. The scripts use AWS IAM for authentication and include support for IAM roles.
Available metrics include:
- Memory Utilization (%)
- Memory Used (MB)
- Memory Available (MB)
- Swap Utilization (%)
- Swap Used (MB)
- Disk Space Utilization (%)
- Disk Space Used (GB)
- Disk Space Available (GB)
The scripts submit memory and disk space usage metrics as Amazon CloudWatch Custom Metrics. Standard Amazon CloudWatch free tier quantities and pricing apply. This is an unsupported sample but we appreciate all feedback, comments and questions you post to the AWS forums.
To learn more about how to use the scripts, including setup and configuration, please visit "Amazon CloudWatch Monitoring Scripts for Linux" in the Amazon CloudWatch Developer Guide.
- 2015-02-25-Updated to enable support in China (Beijing) and EU (Frankfurt) regions.
- 2013-02-24-Added IAM, Auto Scaling and aggregate metric support.
- 2013-03-01-Initial release.