ZenPack:AWS RDS Monitoring

From Zenoss Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search
Author(s)
Jerome C. Ortega
Current Maintainer(s)
Jerome C. Ortega
Organization
Cascadeo
License
GNU General Public License, Version 2, or later
ZenPack name
ZenPacks.Cascadeo.ZenRDS
More Information
GitHub page/HomePage
Link to more docs
View Documentation
Git sources (for cloning)
Link




AWS RDS Monitoring ZenPack

AWS RDS Monitoring

Warning

The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.

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

Discuss

Purplemarker.png New: Don't forget to add yourself to the Zenoss User Map!

blog comments powered by Disqus