How do I instrument AWS Red Hat instances?

These instructions apply to a manual installation of an agent on Red Hat Linux running under AWS.

1. Connect to the AWS Red Hat instance that you want to instrument.
   
   
2. Install required packages by entering:

   sudo yum install perl-Switch perl-DateTime perl-Sys-Syslog perl-LWP-Protocol-https -y

3. Download the Cloudwatch monitoring scripts with curl http://aws-cloudwatch.s3.amazonaws.com/downloads/CloudWatchMonitoringScripts-1.2.1.zip -O
   
   
4. Install the unzip package by entering:

   sudo yum install unzip -y

5. Unzip CloudWatchMonitoringScripts-1.2.1.zip
   
   
6. Remove CloudWatchMonitoringScripts-1.2.1.zip
   
   
7. Change to the directory aws-scripts-mon
   
   
8. Copy awscreds.template to awscreds.conf
   
   
9. Edit awscreds.conf and enter your AWS Access Key and your AWS Secret Key, e.g.:

   AWSAccessKeyID=<AWS Access Key>

   or

   AWSSecretKey=<Secret Key>

10. Install sudo yum -y install perl-Digest-SHA.x86_64
    
    
11. Check it works by running the command:

    ./mon-put instance-data.pl --mem-util --aws-credential-file=./awscreds.conf

    Note, you must ensure you have the perl-Digest-SHA model installed, to check for which you can use the following command:

    sudo yum install perl-Digest-SHA

    If successful, metrics will be reported to CloudWatch. Reference Id: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
    
    
12. Schedule the regular data upload every five minutes by adding the following line to crontab:

    */5 * * * * ~/aws-scripts-mon/mon-put-instance-data.pl --mem-used-incl-cache-buff --mem-util --disk-space-util --disk-path=/ --from-cron