ZenPack:Holt-Winters Threshold

From Zenoss Wiki
This is the approved revision of this page, as well as being the most recent.
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.

Organization
Zenoss, Inc.
ZenPack name
ZenPacks.zenoss.ZenHoltWinters




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.

Warning

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.

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

Prerequisite Restriction
Product Zenoss platform 4.x, Zenoss 2.2 or higher
Required ZenPacks ZenPacks.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
    Name Description
    Rows The number of points to use for predictive purposes.
    Alpha A number from 0 to 1 that controls how quickly the model adapts to unexpected values.
    Beta A number from 0 to 1 that controls how quickly the model adapts to changes in unexpected rates changes.
    Season The 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


Discuss

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

blog comments powered by Disqus