https://github.com/mlabouardy/mon-put-instance-data

Publish Custom CloudWatch Metrics 📈
https://github.com/mlabouardy/mon-put-instance-data

aws cloudwatch docker golang metrics monitoring system

Last synced: about 9 hours ago
JSON representation

Publish Custom CloudWatch Metrics 📈

• Host: GitHub
• URL: https://github.com/mlabouardy/mon-put-instance-data
• Owner: mlabouardy
• License: mit
• Created: 2018-03-22T17:54:20.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-02T10:15:57.000Z (about 6 years ago)
• Last Synced: 2024-06-20T03:25:36.713Z (5 months ago)
• Topics: aws, cloudwatch, docker, golang, metrics, monitoring, system
• Language: Go
• Homepage:
• Size: 1.17 MB
• Stars: 20
• Watchers: 3
• Forks: 10
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Docker Stars](https://img.shields.io/docker/pulls/mlabouardy/mon-put-instance-data.svg)](https://hub.docker.com/r/mlabouardy/mon-put-instance-data/) 

[![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE) [![Docker Stars](https://img.shields.io/github/issues/mlabouardy/mon-put-instance-data.svg)](https://github.com/mlabouardy/mon-put-instance-data/issues)  

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

* [Publish Custom Metrics to AWS CloudWatch](http://www.blog.labouardy.com/publish-custom-metrics-aws-cloudwatch/)