开源软件名称（OpenSource Name）：

开源软件地址(OpenSource Url)：

开源编程语言(OpenSource Language)：

开源软件介绍(OpenSource Introduction)：

aws-mon-linux

Bash script that reports custom metric data about Linux performance to Amazon CloudWatch

This script is intended for use with Amazon EC2 instances running Linux operating systems. The scripts have been tested on the following Amazon Machine Images (AMIs) for both 32-bit and 64-bit versions:

• Amazon Linux 2014.3
• Red Hat Enterprise Linux 6.4
• Ubuntu Server 13.10

The script is written in simple Bash, so you can use it very easily. The script is almost compatible with Amazon CloudWatch Monitoring Scripts for Linux, so you can use almost same options.

Metrics of This Script

This script can report the following metrics:

• load average
• interrupt
• context switch
• cpu (user/system/idle/wait/steal)
• memory
• swap
• disk

Prerequisites

This script requires AWS Command Line Interface.

Amazon Linux

Instances that you launch using the Amazon Linux AMI already include the CLI tools.

All you have to do is to install git.

yum install git

RHEL, Ubuntu

RHEL

Install git.

yum install git

Ubuntu

Install git, unzip and jre.

apt-get install git
apt-get install unzip
apt-get install default-jre

RHEL, Ubuntu

You can install AWS Command Line Interface with following steps:

pip install awscli

Getting Started

Download "aws-mon.sh" or clone repository using following steps:

git clone https://github.com/moomindani/aws-mon-linux.git
cd aws-mon-linux
./aws-mon.sh --help

Using the Script

This script collects load average, cpu, memory, swap, and disk space utilization data on the current system. It then makes a remote call to Amazon CloudWatch to report the collected data as custom metrics.

Option

Examples

The following examples assume that you have already configured awscli with "aws configure".

To perform a simple test run without posting data to CloudWatch

• Run the following command:

./aws-mon.sh --mem-util --verify --verbose

To collect all available cpu metrics and send them to CloudWatch

• Run the following command:

./aws-mon.sh --cpu-us --cpu-sy --cpu-id --cpu-wa --cpu-st

To collect all available memory metrics and send them to CloudWatch

• Run the following command:

./aws-mon.sh --mem-util --mem-used --mem-avail

To collect all available disk metrics and send them to CloudWatch

• Run the following command:

./aws-mon.sh --disk-space-util --disk-space-used --disk-space-avail --disk-path /

To collect all load average metrics and send them to CloudWatch

• Run the following command:

./aws-mon.sh --load-ave1 --load-ave5 --load-ave15

To set a cron schedule for metrics reported to CloudWatch

1. Start editing the crontab using the following command:

crontab -e

2. Add the following command to report all items to CloudWatch every five minutes:

*/5 * * * *  ~/aws-mon-linux/aws-mon.sh --all-items --disk-path=/ --from-cron