From Zenoss Wiki
Revision as of 21:46, 15 September 2014 by Pcarinhas (Talk | contribs)$7

Jump to: navigation, search

Note: This ZenPack is available in commercial versions of Zenoss. Click here to request more information about this commercial ZenPack. Click here to see all commercial ZenPacks.

Zenoss, Inc.
ZenPack name
Git sources (for cloning)

Applications Monitored: 

ControlCenter ZenPack

This ZenPack monitors the ControlCenter application management and orchestration system.


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 ZenPack is included with commercial versions of Zenoss and enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.


Version 1.0.0
Released on 2014/10/30
Compatible with Zenoss Core 4.2.x


This ZenPack is included with commercial versions of Zenoss and enterprise support for this ZenPack is provided to Zenoss customers with an active subscription.


This ZenPack treats the databases as the fundamental component thereby allowing multiple databases to be associated with a single server.


  • ControlCenter must be running and listening on a target device's HTTPS port.
  • ControlCenter access credentials for the monitor user must be provided



CCZP features include:

  • Dynamically generated templates based completely on the ControlCenter API
  • Monitoring of Pools, Hosts, Services, RunningServices
  • Graphs for Memory, CPU, and Page Faults
  • Selected Thresholds

ControlCenter Structure

The structure used to model the ControlCenter is given by the following YUML:

// --------------------------------------------
// Containing
// --------------------------------------------
[ControlCenter]++pools -controlcenter[Pool]
[ControlCenter]++hosts -controlcenter[Host]
[ControlCenter]++services -controlcenter[Service]
[ControlCenter]++running -controlcenter[Running]
// --------------------------------------------
// Non-Containing
// --------------------------------------------
// Host can only be in one Pool
[Pool]0..1poolHosts -.-hostPool *[Host]
// Pool can have many childPools
[Pool]*parentPool -.-childPools 0..1[Pool]
// Pool can have many Services
[Pool]0..1assignedServices -.-assignedPool *[Service]
// Pool can have many Running Services
[Pool]0..1assignedRunnings -.-runPool *[Running]
// Service has many Running svcs (service_definition ->> instances).
[Service]0..1serviceRuns -.-serviceDef *[Running]
// Service can have many child Services
[Service]*parentService -.-childServices 0..1[Service]
// Running has one Host
[Running]*runHost -.-hostRuns 0..1[Host]

ControlCenter Structure


All objects will be automatically discovered via ControlCenter API.

Impact Support

In the ControlCenter, the natural objects are Pools, Hosts, Services, and RunningServices. The following basic hierarchy is supported:

  • Pools: Contain Hosts, Services, RunningServices, and other Pools
  • Hosts: Contain RunningServices
  • Services: Define all services that will run on Hosts
  • RunningServices: Are running instances of the Service definitions

In addition to the base hierarchy above we also have relationships between the objects based on TCP/UDP "Endpoint" port connections.

In order to make the Impact relationships easier to understand we use the following rules:

  • Objects who have a parent-child relationship are mapped directly
  • Objects that have Endpoints are mapped to their respective targets
  • Indirect Endpoints are re-mapped onto their Service definition
  • RunningServices are mapped to their Service definition


; width
565 px
372 px

Impact Structure

Installed Items

Installing this ZenPack will add the following items to your Zenoss system:

Configuration Properties

The credential setup for the CCZP is very simple. You are only required to enter credentials (username, password) when you monitor a non-local installation of your ControlCenter.

  • zControlCenterHost ( Defaults to device name )
  • zControlCenterPort ( Defaults to HTTPS TCP/443 )
  • zControlCenterUser
  • zControlCenterPassword
  • zControlCenterPerfCycle: Performance collection interval (Default 300s)
  • zControlCenterModelCycle: Modeling interval (Default 3600s)

Modeler Plugin

  • zenoss.ControlCenter

Datasource Types

  • Automatically generated from the ControlCenter API

Monitoring Templates

  • Automatically generated from the ControlCenter API

Installation and Configuration

Installation consists of the following steps which will be covered in depth:

  • Install the ZenPack on Zenoss
  • Install the target device in Zenoss
  • Bind the plugin modeler template to server
  • Set the zXYZConnectionStrings property
  • Model the device

Install the ZenPack

  • If the CCZP was installed automatically, you don't need to do or restart anything.
  • If CCZP was not installed by default, install the CCZP zenpack as usual. Make sure you restart all services before continuing.

Install the Target Device in Zenoss

Install the target server as you normally would.

Set the Credentials


If your CCZP lives on the same ControlCenter you are monitoring, you don't need to do anyting: CCZP get's its credentials from the local container that runs it.


If you are modeling a different ControlCenter that is remote to the CCZP installation, you must set the credentials as follows:

  • Select your device from the Infrastructures Tab
  • Click on Configuration Properties
  • Search for zControlCenterUser: Enter your username for ControlCenter
  • Search for zControlCenterPassword: Enter your password for ControlCenter

Batch Configuration with zenbatchload

You can also add your devices in batch for convenience and automation.

  • Create a text file (filename: /tmp/db2.txt). Each server has a stanza like
  • Run the command on the terminal
zenbatchload /tmp/db2.txt

Model the ControlCenter

  • From the device view, select Model Device from the gear menu.
  • If all goes will Zenoss should model the device.
  • Since the Pools, Hosts, Services, and RunningServices are just components of the server, you should see them hanging off of the device as components.


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.ControlCenter-*.egg
  4. Restart these services:
    $ zenoss restart


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

blog comments powered by Disqus