/mon-put-instance-data

Publish Custom CloudWatch Metrics 📈

Primary LanguageGoMIT LicenseMIT

Docker Stars MIT License Docker Stars

Download

Below are the available downloads for the latest version of CLI (1.0.0). Please download the proper package for your operating system and architecture.

Linux:

wget https://s3.us-east-1.amazonaws.com/mon-put-instance-data/1.0.0/linux/mon-put-instance-data

Windows:

wget https://s3.us-east-1.amazonaws.com/mon-put-instance-data/1.0.0/windows/mon-put-instance-data

How to use

  • Setup an IAM Policy:
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "1",
            "Effect": "Allow",
            "Action": "cloudwatch:PutMetricData",
            "Resource": "*"
        }
    ]
}
  • Start metrics collector:
mon-put-instance-data --memory --swap --disk --network --docker --duration 1

Docker

Use the official Docker image:

docker run -d -e AWS_INSTANCE_ID="" -e AWS_ACCESS_KEY_ID="" -e AWS_SECRET_ACCESS_KEY="" --name collector mlabouardy/mon-put-instance-data --memory --swap --interval 1

If you omit the AWS_INSTANCE_ID it'll get the instance id from http://169.254.169.254/latest/meta-data/instance-id

Metrics

  • Memory
    • Memory Utilization (%)
    • Memory Used (Mb)
    • Memory Available (Mb)
  • Swap
    • Swap Utilization (%)
    • Swap Used (Mb)
  • Disk
    • Disk Space Utilization (%)
    • Disk Space Used (Gb)
    • Disk Space Available (Gb)
  • Network
    • Bytes In/Out
    • Packets In/Out
    • Errors In/Out
  • Docker
    • Memory Utilization per Container
    • CPU User/System per Container

Supported AMI

  • Amazon Linux
  • Amazon Linux 2
  • Ubuntu 16.04
  • Microsoft Windows Server

Tutorial