Zenoss

Send monitoring events from Zenoss to BigPanda.

Supported VersionsTypeAuthentication Type
Zenoss Core 4, 5, 6AgentOrg Bearer Token

Zenoss monitors performance and availability across your IT infrastructure. The BigPanda Agent queries for all new Zenoss events and for changes in event states in real-time via the Zenoss API. To ensure a full sync of all current alerts, the agent also queries for all Zenoss events at regular, configurable intervals.

Key Features

  • Keeps you up-to-date on the status of Zenoss events and all relevant event attributes.

  • Correlates Zenoss events into actionable incidents in BigPanda, so you can easily manage the events and the associated devices.

How and When Alerts are Closed

When Zenoss sends a close event for an alert, the alert is automatically closed in BigPanda. However, closing an alert manually in BigPanda does not close the alert in Zenoss.

Install the Integration

Administrators can install the integration by following the on-screen instructions in BigPanda.

Zenoss Data Model

BigPanda normalizes alert data from Zenoss into tags. You can use tag values to filter the incident feed and to define filter conditions for Environments. The primary and secondary properties are also used during the deduplication and correlation processes.

Standard Tags

TagDescriptionAttributes
deviceName of the device for which the event occurred.Primary Property
checkEvent key (or event class, if the event key does not exist) and component, if it exists.

For example: "/Status/Heartbeat on zenmodeler"
Secondary Property
severityNumber representing the severity of the event, mapped to:

'0': 'Clear'
'2': 'Info'
'3': 'Warning'
'4': 'Error'
'5': 'Critical'
summarySummary of the event.
messageMessage body of the event. This value may be the same as the summary.
componentZenoss daemon reporting the event.
event_classEvent class the event maps to.
event_keyUser-defined mapping for the event.
ip_addressIP address of the device.
prod_stateProduction state of the device.
systemsNames of the Zenoss system organizers for the device.
stateChangeWhen state of the device last changedUsed as alert timestamp
device_groupsNames of the Zenoss group organizers for the device.
device_classDevice class.
device_urlURL of the device.
locationNames of the Zenoss location organizers for the device.
monitorMonitor for the device.

Customize Zenoss

To ensure a full sync of all current alerts, the BigPanda agent queries for all Zenoss events at regular intervals. You can configure the query interval or disable the full sync by editing the config file for the agent.

Before You Start

Obtain access to the server where the BigPanda agent is installed.

Install the Integration

Administrators can install the integration by following the on-screen instructions in BigPanda.

Configure the Query Interval

You may want to configure the full sync to reduce the load on your Zenoss server, depending on the average volume of events Zenoss generates.

  1. Open the config file, which is located at /etc/bigpanda/bigpanda.conf.
  2. Locate the settings for the Zenoss full sync, named zenoss/fullsync.
  3. Change the value of the full_sync_interval to your preferred interval between full syncs, in seconds. The default value is 900 (15 minutes).

Disable the Full Sync

๐Ÿ“˜

The full sync acts as a backup to the incremental sync to ensure accuracy. Disable this feature only if you need to reduce the load on your Zenoss server.

  1. Open the config file, which is located at /etc/bigpanda/bigpanda.conf.
  2. Locate the settings for the Zenoss full sync, named zenoss/fullsync.
  3. Add the following key and value pair: "enabled": false.

โ—๏ธ

Make sure you add the pair outside of the config property.

"name": "zenoss/fullsync", 
"enabled": false, 
"config": {
  "user": "BigPanda",...
  },

Uninstall the Integration

To stop sending Zenoss events to BigPanda, you can uninstall the agent from the server or remove the Zenoss integration from the agent.

Before You Start

  • Manually resolve any open incidents related to the integration to remove them from your incident feed. Optionally, remove any additional data in BigPanda. For example, modify or remove any Environments or AutoShare rules that reference the integration.

  • Obtain access to the server where the BigPanda agent is installed.

  • Determine if the agent on the server supports only the Zenoss integration or supports multiple BigPanda integrations.

  • Determine the OS on the server.

๐Ÿšง

When replacing an existing integration with a new tool or system, we recommend configuring the new integration first to ensure no data is lost.

Uninstall the Agent

If the agent supports only the Zenoss integration, you can uninstall the agent from the server.

๐Ÿ“˜

Do not uninstall the BigPanda agent if it is supporting other BigPanda integrations. In this case, remove the Zenoss integration from the agent.

Remove the Zenoss Integration from the Agent

If the agent is supporting multiple integrations, you can remove only the specific integration without disabling the other BigPanda integrations that the agent supports.

  1. Stop the BigPanda agent by running the following command.

sudo service bigpanda stop

  1. Remove the integration from the agent configuration file by running the following command.

sudo bigpanda-config -r <INTEGRATION APP KEY>

โ—๏ธ

Replace the app key with the corresponding value in BigPanda.

sudo bigpanda-config -r <INTEGRATION APP KEY>

  1. Start the BigPanda agent by running the following command.

sudo service bigpanda start

Delete the Integration from BigPanda

  1. In BigPanda, navigate to the Integrations tab and select the desired integration from the list.
  2. In the integration details on the right, click Delete Integration. A support message opens, pre-populated with a request to delete the selected integration.
  3. Press Enter to send the request.
  4. The BigPanda support team will remove the integration from the UI.

โ—

๏ธ

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.