DEV Community

Cover image for Monitor EC2 memory and disk with CloudWatch AgentπŸ•΅πŸ½
DevOps Descent
DevOps Descent

Posted 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": [
          "/"
        ]
      }
    }
  }
}

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-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!

Youtube vedio:https://shorturl.at/lVi2G
GitHub Gist: https://tinyurl.com/yc5v4kne

Top comments (2)

Collapse
 
ankurk91 profile image
Ankur K

Very well documented 🀌

Collapse
 
devops_descent profile image
DevOps Descent

Thanks