You are here

Integrations

AWS - Overall Status

Download version    6.0    5.x

Included in Opsview Monitor 5.x
Included in Opsview Monitor 6.0
check_circle
Opsview Supported

AWS - Overall Status Opspack

This Opspack supports Amazon Cloudwatch for EC2, ELB, and RDS instances. It monitors and returns performance metrics for:

  • EC2: Instance CPU Utilization Disk Read/Write in Bytes or IOPS and Network In/Out.
  • ELB: Healthy and Unhealthy host count, request count and latency.
  • RDS: instance CPU utilization, DB Connections, Free Storage, Read and Write IOPS, Read and Write Latency, and Read and Write Throughput.

Prerequisites

Ruby

The ruby “Cloudscripts” gem is used with this Opspack and should be installed as the nagios user. Ruby and rubygems should be available on your system and already use the command:

gem install CloudyScripts

On Ubuntu 10 Lucid, you should also install SSL support for Ruby:

apt-get install libopenssl-ruby

Security

An RSA key must be generated and saved to enable encryption of your AWS details. Use the commands: mkdir /etc/cloutomate/ ssh-keygen -f /etc/cloutomate/cloutomate.pem …entering a blank passphrase, to create this file.

Note: sudo may be required in order to execute these commands, although the files cloutomate.pem and aws_credentials.cfg must be owned by nagios user; otherwise the values cannot be read by the plugin.

Amazon

You will need access to the Amazon Web Services account you wish to monitor, along with a valid Access Key and its Secret Key. See Amazon's Documentation for information about using keys for security.

Configuration

Creating a credentials file

First, use the encrypt_aws_credentials.rb script to generate your credentials file:

ruby /usr/local/nagios/libexec/plugins.d/cloud-aws/encrypt_aws_credentials.rb -A (your Amazon access key ID) -S (your Amazon secret key) -f /usr/local/nagios/etc/aws_credentials.cfg

You can find your Access Key(s) by logging into the AWS site and accessing "Security Credentials" from your account's drop-down. If you don't know the Secret Key, you may need to create a new key.The created file must not be distributed down to slaves.

Your Amazon host

You will need to know the Amazon server to enter as the Primary Hostname. This will be shown under “Public DNS” in the instance information on Amazon's Management Console.

Variables

AWS_CLOUDWATCH_CREDENTIALS must have 'arg2' set to the Amazon Instance ID - also available from the AWS Management Console.

Example Installation

Environment:

CLI:

sudo mkdir /etc/cloutomate sudo ssh-keygen -f /etc/cloutomate/cloutomate.pem sudo gem install CloudyScripts sudo ruby /usr/local/nagios/libexec/plugins.d/cloud-aws/encrypt_aws_credentials.rb -A (Amazon Access ID) -S (Amazon Secret Key) -f /usr/local/nagios/etc/aws_credentials.cfg sudo chown -R nagios:nagios /etc/cloutomate sudo chown nagios:nagios /usr/local/nagios/etc/aws_credentials.cfg

Service Checks

Service Check Description
AWS Service Status Use this multi-attribute friendly check to monitor AWS services and their statuses

AWS - Overall Status Opspack

This Opspack supports Amazon Cloudwatch for EC2, ELB, and RDS instances. It monitors and returns performance metrics for:

  • EC2: Instance CPU Utilization Disk Read/Write in Bytes or IOPS and Network In/Out.
  • ELB: Healthy and Unhealthy host count, request count and latency.
  • RDS: instance CPU utilization, DB Connections, Free Storage, Read and Write IOPS, Read and Write Latency, and Read and Write Throughput.

Service Checks

Service Check Description
AWS Service Status Use this multi-attribute friendly check to monitor AWS services and their statuses

Setup and Configuration

To configure and utilise this Opspack, you simply need to add the 'Cloud - AWS - Overall Status' to the host running the Overall Status software, and specify the Overall Status port via the variable AWS-SERVICE which needs to be added to the host.

Step 1: Add the host template

Add host template

Step 2: Add and configure variables required for this host

Add variable

Step 3: Reload and the system will now be monitored

View output

Prerequisites

Ruby

The ruby “Cloudscripts” gem is used with this Opspack and should be installed as the opsview user. Ruby and rubygems should be available on your system and already use the command:

gem install CloudyScripts

On Ubuntu 10 Lucid, you should also install SSL support for Ruby:

apt-get install libopenssl-ruby

Security

An RSA key must be generated and saved to enable encryption of your AWS details. Use the commands: mkdir /etc/cloutomate/ ssh-keygen -f /etc/cloutomate/cloutomate.pem …entering a blank passphrase, to create this file.

Note: sudo may be required in order to execute these commands, although the files cloutomate.pem and aws_credentials.cfg must be owned by opsview user; otherwise the values cannot be read by the plugin.

Amazon

You will need access to the Amazon Web Services account you wish to monitor, along with a valid Access Key and its Secret Key. See Amazon's Documentation for information about using keys for security.

Configuration

Creating a credentials file

First, use the encrypt_aws_credentials.rb script to generate your credentials file:

ruby /opt/opsview/monitoringscripts/etc/plugins/cloud-aws/encrypt_aws_credentials.rb -A (your Amazon access key ID) -S (your Amazon secret key) -f /opt/opsview/monitoringscripts/etc/plugins/cloud-aws/aws_credentials.cfg

You can find your Access Key(s) by logging into the AWS site and accessing "Security Credentials" from your account's drop-down. If you don't know the Secret Key, you may need to create a new key.The created file must not be distributed down to slaves.

Your Amazon host

You will need to know the Amazon server to enter as the Primary Hostname. This will be shown under “Public DNS” in the instance information on Amazon's Management Console.

Variables

AWS_CLOUDWATCH_CREDENTIALS must have 'arg2' set to the Amazon Instance ID - also available from the AWS Management Console.

Example Installation

Environment:

CLI:

sudo mkdir /etc/cloutomate sudo ssh-keygen -f /etc/cloutomate/cloutomate.pem sudo gem install CloudyScripts sudo ruby /opt/opsview/monitoringscripts/etc/plugins/cloud-aws/encrypt_aws_credentials.rb -A (Amazon Access ID) -S (Amazon Secret Key) -f /opt/opsview/monitoringscripts/etc/plugins/cloud-aws/aws_credentials.cfg sudo chown -R opsview:opsview /etc/cloutomate sudo chown opsview:opsview /opt/opsview/monitoringscripts/etc/plugins/cloud-aws/aws_credentials.cfg

Setup and Configuration

To configure and utilise this Opspack, you simply need to add the 'Cloud - AWS - Overall Status' to the host running the Overall Status software, and specify the Overall Status port via the variable AWS-SERVICE which needs to be added to the host.

Step 1: Add the host template

Add host template

Step 2: Add and configure variables required for this host

Add variable

Step 3: Reload and the system will now be monitored

View output

v1.0-opsview-5

ODI-604 Release Opspacks to GitHub

Initial upload of existing Opspacks to GitHub

v2.0-opsview-6

ODI-1154 Release Opspacks for Opsview Monitor 6.0

Initial release of Opspack to work with Opsview Monitor 6.0