🚀 CloudWatch Agent Setup on AWS EC2: Collect Memory & Disk Metrics 🖥️📊
In this guide, you'll learn how to install and configure the CloudWatch Agent on an EC2 instance to collect custom memory and disk usage metrics.
📝 Step 1: Check EC2 Instance Architecture
- SSH into your EC2 instance.
- Run this command to check the architecture:
uname -m
This will return x86_64
or aarch64
, depending on your instance type.
🔧 Step 2: Install CloudWatch Agent
Download the CloudWatch Agent as per the AWS Official Docs. If you’re running Ubuntu 24.04
on x86_64
architecture, here’s how to proceed:
cd ~ wget https://amazoncloudwatch-agent.s3.amazonaws.com/ubuntu/amd64/latest/amazon-cloudwatch-agent.deb sudo apt install ./amazon-cloudwatch-agent.deb rm -f ./amazon-cloudwatch-agent.deb
Enable the service:
sudo systemctl enable amazon-cloudwatch-agent.service
⚙️ Step 3: Configure the CloudWatch Agent for Custom Metrics
Create a configuration file to specify which metrics to collect. Run:
sudo nano /opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.d/file_config.json
Copy and paste this JSON:
{ "agent": { "metrics_collection_interval": 60, "run_as_user": "root" }, "metrics": { "aggregation_dimensions": [ [ "InstanceId" ] ], "metrics_collected": { "mem": { "measurement": [ "mem_used_percent" ] }, "disk": { "measurement": [ "disk_used_percent" ], "resources": [ "/" ] } } } }
Save and exit.
🔄 Step 4: Restart CloudWatch Agent🕵🏽
Apply the changes by restarting the service:
sudo systemctl restart amazon-cloudwatch-agent.service
✅ Step 5: Verify the Agent Status
Make sure the CloudWatch Agent is running:
sudo systemctl status amazon-cloudwatch-agent.service
🔒 Step 6: Create EC2 IAM Role
- Create a new IAM role for your EC2 instance.
- Attach the CloudWatchAgentServerPolicy to the role.
- Assign the IAM role to your EC2 instance.
For a detailed step-by-step guide, check the official AWS docs.
🔧 Troubleshooting
- Check configuration syntax before restarting the agent.
- View agent logs for any errors:
cat /var/log/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.log
📚 Reference Docs
That's it! 🎉 Your EC2 instance should now be sending memory and disk usage metrics to CloudWatch!
Support if you found this helpful😉
No Money 🙅🏻♀️ just Subscribe
Do check: https://linktr.ee/DevOps_Descent
Youtube: https://shorturl.at/lVi2G
GitHub Gist: https://tinyurl.com/yc5v4kne
Top comments (2)
Thanks