7.7.4.12 CREATE THRESHOLD
Purpose
The CREATE THRESHOLD
command creates a threshold object that specifies the conditions for generation of a metric alert.
Syntax
CREATE THRESHOLD name attributename=value [, attributename=value]...
Usage Notes
The attributes that can be specified are comparison
, critical
, occurrences
, observation
, and warning
.
-
The name argument is required. The name is comprised of a metric name and an object name with the format
metricName.objectName
, such asdb_io_rq_sm_sec.db123
orct_io_wt_rq.interactive
. Use theLIST METRICCURRENT metric
command to display the available object name for metric. The object name is optional. -
When a object name is not specified, then the threshold is applied to all metric objects for the given metric.
-
The
comparison
attribute is required with a condition value. The value must be'<'
,'<='
,'='
,'>='
, or'>'
. -
The
occurrences
attribute specifies the number of consecutive measurements over the threshold value that trigger a state change. -
The
observation
attribute is the number of measurements over which measured values are averaged. -
A state change to the value set in
warning
orcritical
causes a stateful alert to be generated. -
The
GD_SP_PRCT_ALLOCATED
metric has a built-in threshold, and automatically sends alerts. Create thresholds for other metrics to receive alerts for those metrics.
When specifying occurrences and observations, you need the specified number of consecutive occurrences of sample averages over the number of observations to cause an alert. For example, if the following five observations (observations=5
) happen on a cell, then the average sample would be 10 because the number of consecutive occurrences (occurrences=2
) had values of 5 and 15.
Observation 1: 0 Observation 2: 30 Observation 3: 0Observation 4: 5
Observation 5: 15
Example 7-92 Creating a Threshold
This example shows how to create a threshold.
CellCLI> CREATE THRESHOLD db_io_rq_sm_sec.db123 comparison='>', critical=120
CellCLI> CREATE THRESHOLD ct_io_wt_sm.interactive warning=10, critical=20, -
comparison='=', occurrences=2, observation=5
Related Topics
Parent topic: CREATE