ZenPack:AWS RDS Monitoring
- 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
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)
- Download the appropriate egg file for the version of Zenoss you are running.
- Ensure you are logged in as the zenoss user:
$ sudo su - zenoss
- Install the ZenPack:
$ zenpack --install ZenPacks.Cascadeo.ZenRDS-*.egg
- 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:
- Ensure you are logged in as the zenoss user:
$ sudo su - zenoss
- Start by cloning the upstream repository:
$ git clone git://github.com/cascadeo/ZenPacks.Cascadeo.ZenRDS.git
- Next, perform the installation:
$ zenpack --link --install ZenPacks.Cascadeo.ZenRDS
- Finally, restart these serivices:
$ zenoss restart
Discuss
New: Don't forget to add yourself to the Zenoss User Map!