ZenPacks

ControlCenter ZenPack

This ZenPack monitors the ControlCenter application management and orchestration system.

Support

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

Releases

Version 1.2.0- Download
Summary of changes: .
  • Improve device status events
  • Added health-checks for running services
Released on 2016/06/02
Requires ZenPacks.zenoss.PythonCollector 1.5+ ZenPack
Compatible with Zenoss Core 5.1.x, Zenoss Resource Manager 5.1.x
Version 1.0.1- Download
Released on 2015/07/04
Requires ZenPacks.zenoss.PythonCollector 1.5+ ZenPack
Compatible with Zenoss Core 5.0.x, Zenoss Resource Manager 5.0.x
Version 1.0.0- Download
Released on 2015/02/18
Compatible with Zenoss Core 5.0.x, Zenoss Resource Manager 5.0.x

Background

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

Prerequisites

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

Features

CCZP features include:

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

ControlCenter Structure and Discovery

ControlCenter Structure

The following ControlCenter components will be automatically discovered through the modeling process.

CC-Pools
Description: Resource pools that Zenoss services are associated with. Non-Zenoss services will not have a pool and will not be reflected in the Pool grid counts.
Attributes: Memory Capacity, CPU Core Capacity
Relationships: CC-Hosts, CC-Services, CC-Running
CC-Hosts
Description: Host systems that run Zenoss services.
Attributes: CPU Cores, IP Address, Memory
Relationships: CC-Pool, CC-Running
CC-Services
Description: Service definitions that specify service properties and states. Only Zenoss services have an associated CC-Pool.
Attributes: Target State
Relationships: Parent Service, Child Services, CC-Pool, CC-Running
CC-Running
Description: These are the running services defined in CC-Services. Only Zenoss services have an associated CC-Pool.
Attributes: Instances, Status, Service ID, Parent Service ID, Host ID
Relationships: CC-Pool, CC-Host, CC-Service
CC-Volumes
Description: ControlCenter storage volume
Attributes: TotalBytes, UsedBytes, DataFile, Driver. Status
Relationships: None

Impact Support

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

  • Pools: Contain Hosts, Services, Running services, and other Pools
  • Hosts: Contain Running services
  • Services: Define all services that will run on Hosts
  • Running: Are running service 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
  • Running services are mapped to their Service definition

Impact Structure

Note:  Impact Configuration
In order to easily get a full impact diagram for ControlCenter, identify and add 
the top-level service only. This will normally be one of the following:
* Zenoss.resmgr
* Zenoss.core

Installed Items

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

Device Class

This ZenPack adds the /ControlCenter Device Class which is already configured for ControlCenter monitoring after updating the values for the Configuration Properties referenced below.

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.

  • Note: The target device must be a valid DNS resolvable address.

Set the Credentials

note

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.

warning

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 zControlCenter
  • Set your username for zControlCenterUser
  • Set your password for zControlCenterPassword

You must use the same username and password you would normally use to log into the CC interface. This is typically the zenoss account. Test the CC login page directly if you have any doubts.

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
/Devices/ControlCenter
zPythonClass='ZenPacks.zenoss.ControlCenter.ControlCenter'
'mp6.zenoss.loc'
  • 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 Running services are just components of the server, you should see them hanging off of the device as components.

Changes

1.2.0
  • Update device status: ZEN-23413
1.1.0
  • Added distributed storage Volumes
  • Added health-checks for running services
1.0.1
  • Upgrade ZenPackLib to YAML format
  • Fix ZEN-16534: Allow Linux host linking in Impact
1.0.0
  • Initial release

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

Commercial

This ZenPack is developed and supported by Zenoss Inc. Commercial ZenPacks are available to Zenoss commercial customers only. Contact Zenoss to request more information regarding this or any other ZenPacks. Click here to view all available Zenoss Commercial ZenPacks.

randomness