Difference between revisions of "ZenPack:Calculated Performance"

From Zenoss Wiki
Jump to: navigation, search
(Created page with "{{ZenPack |Summary=Adds a Calculated Performance datasource that can store the result of a calculation of other datasources or model attributes. |Organization=Zenoss, Inc. |Ze...")
 
m
Line 4: Line 4:
 
|ZenPack name=ZenPacks.zenoss.CalculatedPerformance
 
|ZenPack name=ZenPacks.zenoss.CalculatedPerformance
 
|Source URI=git://github.com/zenoss/ZenPacks.zenoss.CalculatedPerformance.git
 
|Source URI=git://github.com/zenoss/ZenPacks.zenoss.CalculatedPerformance.git
|Releases=
+
|Releases={{Release
 +
|Version=1.0.5
 +
|Tag=1.0.5
 +
|Release date=2013/04/03
 +
|Compatible with=Zenoss Core 3.1.x, Zenoss Core 3.2.x, Zenoss Core 4.2.x, Zenoss Resource Manager 4.1.x, Zenoss Resource Manager 4.2.x
 +
}}
 
|Devices=
 
|Devices=
 
|Applications=
 
|Applications=
Line 48: Line 53:
 
attribute with the same name as an RRD data point the RRD data point
 
attribute with the same name as an RRD data point the RRD data point
 
information would be used to calculate the value.
 
information would be used to calculate the value.
 
 
{{ZenPackFooter}}
 
{{ZenPackFooter}}

Revision as of 04:09, 4 April 2013

Organization
Zenoss, Inc.
License
GNU General Public License, Version 2, or later
ZenPack name
ZenPacks.zenoss.CalculatedPerformance
Git sources (for cloning)
Link




Calculated Performance ZenPack

Adds a Calculated Performance datasource that can store the result of a calculation of other datasources or model attributes.

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 is an Open Source ZenPack developed by Zenoss, Inc. Enterprise support for this ZenPack is available to commercial customers with an active subscription.

Releases

Version 1.0.5- Download
Released on 2013/04/03
Compatible with Zenoss Core 3.1.x, Zenoss Core 3.2.x, Zenoss Core 4.2.x, Zenoss Resource Manager 4.1.x, Zenoss Resource Manager 4.2.x

Background

This ZenPack performs calculations of device or component attributes and provides the results via a new data point value. The new value can then be plotted into a new or existing RRD graph. This extension will add a new daemon, zencalcperfd, and a new data source, Calculated Performance.

As an example, a new data point might take the data from two other data points on the same template, average them and convert the result to a percentage using a modeled device attribute. More concretely, a network IpInterface can be used to take the total number of packets and divide that number by the total number of errors. The resulting value provides the percentage of errors on the interface over time.

Usage

Once the CalculatedPerformance ZenPack is installed you can begin creating new data points.

  1. Navigate to the template that you would like to modify.
  2. From the Data Sources area, click the plus sign to add a new data source.
  3. Provide a unique name for the data source and select Calculated Performance from the drop down list and select Submit.
  4. Double click on the new data source to edit the properties.
  5. Specify the parameters for the data source.
    1. Name: The name of the data source
    2. Expression: Used to create the new data point value.
      For example, (hw.totalMemory – memAvailReal) / hw.totalMemory
      The above expression uses the totalMemory attribute modeled from the device and uses the RRD data point memAvailReal to calculate a percentage used.
    3. Severity: The severity to apply to the event.
    4. Event Class: The event class to which any events will be sent on errors.
    5. Event Key: Used to add uniqueness beyond device and component to event.
  6. Click Save to create the data source and to automatically create a data point.

You now have a new data point to utilize on your graphs that will be calculated every 60 seconds.

Be aware that your expression can contain device attributes and RRD data points from the same class. These will be evaluated in the following order RRD data points followed by device attributes. So in the case where you have a attribute with the same name as an RRD data point the RRD data point information would be used to calculate the value.

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

Developer Mode Installation

In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:

  1. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  2. Start by cloning the upstream repository:
    $ git clone git://github.com/zenoss/ZenPacks.zenoss.CalculatedPerformance.git
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.zenoss.CalculatedPerformance
  4. Finally, restart these serivices:
    $ zenoss restart

Discuss

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

blog comments powered by Disqus