From Zenoss Wiki
Revision as of 21:25, 14 December 2012 by Chet Luther (Talk | contribs)$7

(diff) ← Older revision | Approved revision (diff) | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Chet Luther
Current Maintainer(s)
Chet Luther
Zenoss, Inc.
GNU General Public License, Version 2, or later
ZenPack name
More Information
GitHub page/HomePage
Link to more docs
View Documentation
Git sources (for cloning)

Applications Monitored: 

CloudStack ZenPack

Monitor CloudStack


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.


This is an Open Source ZenPack developed by Zenoss, Inc. Enterprise support for this ZenPack is available to commercial customers with an active subscription.


Version 1.0.6- Download
Released on 2012/10/01
Compatible with Zenoss Core 3.2.x, Zenoss Core 4.2.x, Zenoss Resource Manager 4.1.x, Zenoss Resource Manager 4.2.x


This project is a Zenoss_ extension (ZenPack) that allows for monitoring of CloudStack. An explanation of what CloudStack is can be found at [1].

CloudStack is open source software written in java that is designed to deploy
and manage large networks of virtual machines, as a highly available,
scalable cloud computing platform. CloudStack current supports the most
popular open source hypervisors VMware, Oracle VM, KVM, XenServer and Xen
Cloud Platform. CloudStack offers three ways to manage cloud computing
environments: a easy-to-use web interface, command line and a full-featured



Once you've successfully added a CloudStack cloud to Zenoss you will begin to see the following metrics available for the entire cloud. These numbers are aggregated from all zones, pods, clusters and hosts.

  • Public IPs: Total and Used
  • Private IPs: Total and Used
  • Memory: Total (with and without over-provisioning), Allocated and Used
  • CPU: Total (with and without over-provisioning), Allocated and Used
  • Primary Storage: Total (with and without over-provisioning), Allocated and Used
  • Secondary Storage: Total and Used
  • Network: Read and Write

The same list of metrics are available for each zone. The same metrics with the exception of public IPs and secondary storage are also available for each pod.

The following metrics are available aggregated to each cluster, and for each host.

  • Memory: Total and Used
  • CPU: Total (with and without over-provisioning), Allocated, Used and Cores
  • Network: Read and Write


CloudStack has both alerts and events. Once you've successfully added a CloudStack cloud to Zenoss you will automatically receive all CloudStack alerts as events in Zenoss. You will also automatically receive all CloudStack events. However, the events will go straight into your event history by default.

To avoid overloading CloudStack and Zenoss, only the last two (2) days of events will be checked. This allows for timezone discrepency between the Zenoss and CloudStack servers as well as some downtime without missing events. There is no real-time event collection mechanism with the CloudStack API, so alerts and events will only be polled once per minute.


Installing the ZenPack will add the following items to your Zenoss system.

  • Device Classes
    • /CloudStack
  • Configuration Properties
    • zCloudStackURL
    • zCloudStackAPIKey
    • zCloudStackSecretKey
  • Modeler Plugins
    • zenoss.CloudStack
  • Monitoring Templates
    • Cloud
    • Zone
    • Pod
    • Cluster
    • Host
  • Event Classes
    • /Status/CloudStack
    • /Perf/CloudStack
    • /App/CloudStack

The easiest way to start monitoring CloudStack is to navigate to the Infrastructure page, click the *+* menu to add a device and choose *Add CloudStack*. Fill out the *URL*, *API Key*, and *Secret Key* fields then click *OK*. The URL should only include the protocol, host and port (i.e. *http://cloudstack.example.com/*). You can find or create the keys by logging into the CloudStack web interface and navigate to Accounts and users.

Zenoss will then add the CloudStack device to the system along with all of its associated zones, pods and clusters. Monitoring will also start after the discovery is complete.


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.zenoss.CloudStack-*.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/zenoss/ZenPacks.zenoss.CloudStack.git
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.zenoss.CloudStack
  4. Finally, restart these serivices:
    $ zenoss restart


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

blog comments powered by Disqus