Metric Threshold Monitor
3 minute read
Create a Metric Threshold Monitor
To create a metric threshold monitor:
- Click Monitors and select Manage Monitors.
![](/images/monitors001.png)
- Click + New Monitor and select Metric Threshold.
![](/images/monitors003.png)
Configure Metric Monitor
The metric monitor evaluates metric conditions across all agents in the Fleet. In this example, the Metric and Alert Conditions have been populated.
![](/images/monitors004.png)
Metric
You select a metric and an aggregation to populate the graph. This enables you to see a the historical data for the metric and establish reasonable alert and warning alert conditions.
-
Aggregation: Choose between Sum, Average, Minimum, Maximum, Count and Median. This defines the logic used to create the aggregated value for each Rollup window. Use Aggregation and Rollup Window to shape the base time series. Then use the Evaluation Details options (Aggregation and Evaluation WIndow) to get a scalar threshold from the shaped base time series. See the example that follows.
-
Metric: Select a metric to monitor.
-
Source: Use autocomplete to select the sources you want to monitor. For example you can specify a number of agent tags. If you leave this blank all sources will be monitored.
![](/images/monitors-sources.png)
- Group by: You can group the monitored item by dimensions such as the agent tag, host, namespace etc. This option is required if you want to split notifications by group.
![](/images/group-by-monitors.png)
- Rollup Window: Define the duration with which to shape the base time series, along with the preceding base time series aggregation. Then use the Evaluation Details options (Aggregation and Evaluation WIndow) to get a scalar threshold from the shaped base time series. See the example that follows.
Evaluation Details
The Evaluation Details options evaluate the shaped base time series (as shaped by the preceding aggregation and rollup window options) to determine a value against which to check for thresholds.
- Evaluation Details - Aggregation: The function applied to the shaped time series to determine a value for evaluation against the thresholds.
- Evaluation Details - Evaluation Window: The duration at which to apply the Evaluation Details - Aggregation function.
Example:
- Aggregation: Minimum
- Rollup Window: 5m
- Evaluation Details - Aggregation: Sum
- Evaluation Details - Evaluation Window: 15m
The first two options in this configuration determine the minimum of the metric for each 5 minutes. In other words, every 5 minutes a data point is created.
The second two options in this configuration determine the sum of the data points every 15 minutes (three data points) to create a metric. This metric will be evaluated against the thresholds you will set.
Alert Conditions
Configure the thresholds that the monitored item should be evaluated against in this section. You can select a warning and an alert thresholds. If you are configuring a metric monitor, as you add the thresholds they are displayed in the graph relative to the current metric’s values. You can choose to trigger when the evaluated value is Above
, Above or equal to
, Below
or Below or equal to
the thresholds.
Notification
Metric data item fields
To use Source fields in the notification you must specify them in the Group By field in the Monitor Scope section and in the Group notifications by field in the Notifications section.
![](/images/monitors-notification.png)