×

Ad

Introduction

Setting up the Amazon CloudWatch Agent can streamline monitoring and managing your Amazon EC2 instances. This guide will lead you through the steps to install the CloudWatch Agent on your EC2 instance, making sure it's configured correctly to send data to CloudWatch.

Step 1: Connect to Your EC2 Instance

Before you can install the CloudWatch Agent, you need to connect to your EC2 instance. You can do this using SSH if you're on a Linux instance or by using the EC2 Instance Connect feature for Windows instances.

Step 2: Install the CloudWatch Agent

First, you'll need to download the CloudWatch Agent package. Open a terminal on your EC2 instance and run the following command:

sudo curl -LO https://amazoncloudwatch-agent.s3.amazonaws.com/latest/amazoncloudwatchagent/amazon_linux_2/amd64/latest/amazon-cloudwatch-agent.rpm

Then, install the package:

sudo rpm -Uivh amazon-cloudwatch-agent.rpm

Step 3: Configure the CloudWatch Agent

After installing the CloudWatch Agent, it's important to configure it to meet your needs. To do this, create a configuration file in JSON format. The configuration file specifies which metrics you want to collect and where to stream them. Here’s an example configuration:

{
  "metrics": {
    "append_dimensions": {
      "InstanceId": "$InstanceId"
    },
    "metrics_collected": {
      "cpu": {
        "measurement": [ "cpu_usage_idle", "cpu_usage_iowait" ],
        "metrics_collection_interval": 60
      },
      "disk": {
        "measurement": [ "used_percent", "inodes_free" ],
        "metrics_collection_interval": 60,
        "resources": [ "*" ]
      },
      "memory": {
        "measurement": [ "working_set_size" ],
        "metrics_collection_interval": 60
      },
      "net": {
        "stat": [ "stat_if_octets" ],
        "metrics_collection_interval": 60,
        "resources": [ "*" ]
      },
      "raid_volume": {
        "measurement": [ "reads_completed", "reads_merged", "sectors_read", "writes_completed", "writes_merged", "sectors_written", "io_in_progress", "io_time", "weighted_io_time" ],
        "metrics_collection_interval": 60,
        "resources": [ "*" ]
      }
    }
  }
}

Save this file as cloudwatch-config.json.

Step 4: Start the CloudWatch Agent

With your configuration file ready, you can start the CloudWatch Agent. Use the following command to start it:

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -m ec2 -c file:/path/to/your/cloudwatch-config.json -s

This will start the CloudWatch Agent using the configuration you specified.

Step 5: Verify the Installation

After starting the CloudWatch Agent, you can verify that it is running and sending data to CloudWatch. Navigate to the CloudWatch console and go to the Metrics section. Here, you should see the metrics you configured in your cloudwatch-config.json file. If everything is set up correctly, you'll start to see data appearing in real-time.

Step 6: Troubleshooting

If you encounter issues during installation or configuration, check the CloudWatch Agent logs located at /opt/aws/amazon-cloudwatch-agent/logs/. These logs can help identify any problems that might be preventing your metrics from being sent to CloudWatch.

Conclusion

By following these steps, you should have the CloudWatch Agent installed and configured on your EC2 instance. This setup will allow you to monitor your EC2 instances effectively, helping you to optimize performance and troubleshoot issues as they arise.

×

Ad

×

Ad