How to add a metric trigger

Use this procedure to create a new metric trigger. You must have the Manager role to create a trigger.

1. Open the ADMIN > Actions page, and then click the TRIGGERS tab.

2. In the upper-right corner, click ADD TRIGGER.

   

3. In the Trigger details area, specify the trigger.

   1. In the Trigger name field, enter a name.

      Note that trigger names cannot be changed after the ADD TRIGGER dialog is saved.

   2. (Optional) In the Description field, enter text to describe the trigger.

   3. From the Type list, choose Metrics.

      The ADD TRIGGER dialog expands to include new fields.

      

   4. (Optional) In the Tags field, add one or more terms to associate with the trigger.

4. In the Trigger criteria area, specify a metric and, optionally, one or more entities.

   1. In the Metric name field, enter the name of a metric.

      When you enter the first few letters of a metric name, Zenoss Cloud displays a list of names to choose from. For assistance finding a metric name, see the ADMIN > Metric Dictionary page.

   2. (Optional) Create a query to identify one or more entities that collect the metric.

      For more information, see Trigger queries and Metric trigger fields.

5. Select the threshold type, and then the values to use in comparisons.

   1. From the Thresholds list, select min/max.

      The area to the right of the Threshold list updates to include fields for entering the minimum and maximum values of the threshold and a field for the comparison type.

      

   2. In the first two unlabeled fields, enter a minimum (left field) and a maximum (right field) value, or just a minimum or maximum.

      • When both values are specified, the values define the normal range for data points of the specified metric. When data points are less then the minimum value or greater than the maximum value, the trigger matches.

      • When just a minimum value is specified, the trigger matches when data points are less than the specified value.

      • When just a maximum value is specified, the trigger matches when data points are greater than the specified value.

      The values you specify must be raw (as collected), not normalized values. The dictionary service normalizes some metric values with scale factors.

   3. In the final unlabeled field, change the comparison type, if desired.

      • Value comparisons use data point values.

      • Rate comparisons use the rate (per second) at which the value changes.

        Only positive numbers may be used for minimum and maximum values when the comparison type is Rate.

      • Delta comparisons use the difference between adjacent data points.

        Positive or negative numbers may be used for minimum and maximum values when the comparison type is Delta.

      Note

      Rate and Delta comparisons are based on the last two data points recorded for a metric and are only performed when the rule associated with a metric trigger is enabled.

6. Click SAVE.