ZenPacks

Holt-Winters Threshold ZenPack

The ZenHoltWinters ZenPack adds the ability to create threshold events when a device exceeds cyclical predicted values. The Holt-Winters exponential smoothing algorithm is used for this prediction.

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.

Background

The ZenPacks.zenoss.ZenHoltWinters ZenPack adds the ability to create threshold events when a device exceeds cyclical predicted values.


The Holt-Winters exponential smoothing algorithm is used for predictiond. For more information on RRD and Holt-Winters, refer to the rrdcreate command.

Warning: This ZenPack is not compatible with Zenoss 5 and later.

Warning: Zenoss platform relies on the existence of Holt-Winters RRAs within an RRD file. After adding Holt-Winters thresholds, the RRD files will need to be re-created so that the new configuration can occur. You will have to remove any existing RRD files so that new files can be created.

Removing RRD files will remove all historical information associated with these RRD files.

Prerequisites

PrerequisiteRestriction
ProductZenoss platform 4.x, Zenoss 2.2 or higher
Required ZenPacksZenPacks.zenoss.ZenHoltWinters

Add a Predictive Threshold

  1. Navigate to the template that you want to modify.
  2. From the Thresholds area, click (Add Threshold).
  3. Provide a name for the new threshold and select the HoltWintersFailure threshold type, and then click Add.
  4. Choose the data source to which the threshold should be applied.
  5. Specify the parameters for the prediction engine.
    Predictive Threshold Data Source Threshold Options
    NameDescription
    RowsThe number of points to use for predictive purposes.
    AlphaA number from 0 to 1 that controls how quickly the model adapts to unexpected values.
    BetaA number from 0 to 1 that controls how quickly the model adapts to changes in unexpected rates changes.
    SeasonThe number of primary data points in a season. Note that Rows must be at least as large as Season.

  6. Click Save to save your changes.
  7. Remove the RRD file or files that correspond to the data source selected in a previous step.
    cd $ZENHOME/perf/Devices
    rm device_names/DataSource_DataPoint.rrd

    Note: Removing the RRD files does result in a loss of historical information.

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.ZenHoltWinters-*.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.