ZenPacks

AWS RDS Monitoring ZenPack

AWS RDS Monitoring

Support

This ZenPack is developed by the Zenoss user community and supported via our online forums. Zenoss, Inc. does not provide direct support for this ZenPack.

Background

The ZenRDS ZenPack provides monitoring for AWS RDS instances without installing Zenoss AWS ZenPack. It provides the following performance metrics through CloudWatch API.

"CPUUtilization", "DatabaseConnections", "FreeableMemory", "FreeStorageSpace", "ReadIOPS", "ReadLatency", "ReadThroughput", "SwapUsage", "WriteIOPS", "WriteLatency", "WriteThroughput"


To use Cascadeo ZenRDS Zenpack:

Install Python-Boto on Zenoss Python environment

SSH in to Zenoss and login as zenoss user (important) Download Python Boto library from http://boto.googlecode.com/files/ Untar and install it using python setup tools. python setup.py install

Install Zenpack Code from GitHub

On the zenoss host, clone the latest ZenRDS code Change directory to the zenpack's root dir. Create egg package by executing python setup.py bdist_egg Install the generated egg package/zenpack under dist directory. zenpack --install <Zenpackname.egg> Restart the zopectl and zeoctl daemons, or the whole zenoss stack. Wait for a few seconds and reload the Zenoss UI,

Add your devices to /Server/RDS

The Zenpack will create /Server/RDS device class. Put all RDS intances you want to monitor in /Server/RDS (under infrastructure tab) Disable Ping and SNMP monitoring for the device class.

Configure instance names and secret keys

Go to the "Configuration Properties" for the devie Set the following fields: zRDSIdentity (your AWS identity number), zRDSKey (your AWS secret key), zRDSInstance (the instance name of the RDS) and zRDSRegion (region where the instance is us-east-1, us-west-1, etc). Make sure that the key has at least read-only privilge to the RDS instance. Wait for the data to come in. Run zencommand to force collection, if necessary. Configure threshold levels according to your need in the ZenRDS monitoring template.

Known Issues/Errors

Error importing Boto module. This is a pre-requisite. ** Make sure that zenoss' python environment has access to the Boto library.

Request has expired. Timestamp date: x-x-x-x ** Make sure that system time is accurate AWS RDS

Installation

Normal Installation (packaged egg)

  1. Download the appropriate egg file for the version of Zenoss you are running.
  2. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  3. Install the ZenPack:
    $ zenpack --install ZenPacks.Cascadeo.ZenRDS-*.egg
  4. Restart these services:
    $ zenoss restart

Developer Mode Installation

In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:

  1. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  2. Start by cloning the upstream repository:
    $ git clone git://github.com/cascadeo/ZenPacks.Cascadeo.ZenRDS.git
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.Cascadeo.ZenRDS
  4. Finally, restart these serivices:
    $ zenoss restart

Community

This ZenPack is developed and supported by the Zenoss User Community. Contact Zenoss to request more information regarding this or any other ZenPacks. Click here to view all available Zenoss Community ZenPacks.

randomness