DEV Community

Cover image for Monitor EC2 memory and disk with CloudWatch Agent🕵🏽
DevOps Descent
DevOps Descent

Posted on • Edited on

Monitor EC2 memory and disk with CloudWatch Agent🕵🏽

🚀 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": [ "/" ] } } } } 
Enter fullscreen mode Exit fullscreen mode

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)

Collapse
 
Sloan, the sloth mascot
Comment deleted
Collapse
 
devops_descent profile image
DevOps Descent

Thanks