Creating a Threshold Rule

You can set threshold conditions for resource metrics by setting threshold rules. If a metric value meets the threshold condition, a threshold alarm will be generated. If no metric data is reported, an insufficient data event will be generated.

Creation Methods

There are two creation methods: Directly Creating Threshold Rules and Using Templates to Create Threshold Rules. Only one rule is generated at a time. All resources are monitored using the same rule. To use the second method to create threshold rules, ensure that a static threshold template has been created according to Creating a Static Threshold Template.

Precautions

• If you use a threshold rule to monitor the same metric of multiple resources in batches, pay attention to the following:

  • If the metric status of a resource is Exceeded, the status of the threshold rule is also Exceeded.

  • If the metric status of one or more resources is Insufficient or Normal, the status of the threshold rule is Normal.

Directly Creating Threshold Rules

1. Log in to the AOM console. In the navigation pane, choose Alarm Center > Alarm Rules. Then, click Create Alarm Rule in the upper right corner.

2. Set a threshold rule.

   1. Set basic information such as the rule name and description.

   2. Set details about the rule.

      1. Set Rule Type to Threshold alarm.

      2. Select monitored objects. Use either of the following methods:

         • Select resource objects: Click Select Resource Object, add objects by dimension or resource, and click Confirm.

           Note

           • A threshold rule can monitor up to 100 pieces of metric data.

           • If you enable Apply to All () when selecting objects to monitor, an alarm rule will be created for all metrics of the type you select under an application or service. For example, if you select CCE/Host/Host/CPU Usage and enable Apply to All, an alarm rule will be created for all hosts in CCE.

           • Click Edit resource objects to modify the selected resource object.

         • Command input: Both manual and auto inputs are supported.

           • Manual input: used when you know the metric name and IP address, and you are familiar with the Prometheus format.

             For example, to query the CPU usage of the host, run command avg(label_replace(avg_over_time(aom_node_cpu_usage{hostID="81010a40-1682-41c1-9645-f0588ff9c0cf",nodeIP="192.168.1.210",clusterId = '00000000-0000-0000-0000-00000000'}[59999ms]), "__name__","aom_node_cpu_usage","","")) by(__name__,hostID,nodeIP).

             Note

             For details about Prometheus commands, move the cursor to next to the search box and click Learn more.

           • Auto input: used when you do not know the metric information or are unfamiliar with the Prometheus format. The command can only be automatically filled when you switch from the Metric Monitoring page.

             Specifically, choose Monitoring > Metric Monitoring in the navigation pane. Then, click Add Metric and select Dimension or Resource for Add By. Select up to 12 metrics to monitor. Next, click in the Operation column. The system automatically switches to the threshold rule creation page and fills the Prometheus command for your metric.

      3. Set an alarm condition. Click Custom and set information such as Statistical Period, Consecutive Periods, and Threshold Criterion. Table 1 describes the parameters.

         Table 1 Alarm condition parameters

         Category	Parameter	Description
         Trigger Condition	Statistical Period	Interval at which metric data is collected. By default, only one period is measured. A maximum of five periods can be measured.
         	Consecutive Periods	When the metric value meets the threshold condition for a specified number of consecutive periods, a threshold-crossing alarm will be generated.
         	Statistic	Method used to measure metrics. Options: Avg., Min., Max., Sum, and Samples.
         	Threshold Condition	Trigger condition of a threshold alarm. A threshold condition consists of two parts: operators (>=, <=, >, and <) and threshold value. For example, after Threshold Criterion is set to > 85, if the actual metric value exceeds 85, a threshold alarm is generated. Move the cursor to the graph area above the alarm condition. The ID, IP address, and unit of the current metric are displayed.
         	Alarm Severity	Severity of a threshold alarm. Options: Critical, Major, Minor, and Warning.
         Advanced Settings	Alarm Clearance	An alarm will be cleared if the monitored object does not meet the trigger condition within the monitoring period. By default, metrics in only one period are monitored. You can set up to five monitoring periods.
         	Action Taken for Insufficient Data	Action to be taken when no metric data is generated or metric data is insufficient within the monitoring period. You can set this option based on your requirements. By default, metrics in only one period are monitored. You can set up to five monitoring periods. Options: Alarm, Insufficient data, Keep previous status, and Normal.

         

         Figure 1 Setting an alarm condition

      4. Set alarm tags and annotations to group alarms.

         Click Add Tag or Add Annotation.

3. Click Create Now. As shown in the following figure, a threshold rule is created. Click to monitor the same metric of multiple resources.

   In the expanded list, if the metric data of a host meets the preset alarm condition, a threshold alarm is generated on the alarm page. To view the alarm, go to the AOM console and choose Alarm Center > Alarm List in the navigation pane.

   

   Figure 2 Creating a threshold rule

Using Templates to Create Threshold Rules

Before creating threshold rules, ensure that a static threshold template has been created according to Creating a Static Threshold Template.

1. Log in to the AOM console. In the navigation pane, choose Alarm Center > Alarm Rules. Then, click Create Alarm Rule in the upper right corner.

2. Set a threshold rule.

   1. Set basic information such as the rule name and description.

   2. Set details about the rule.

      1. Set Rule Type to Threshold alarm.

      2. Select monitored objects. When a template is used to create a threshold rule, you can select metrics only by dimension or resource. The command input mode is not supported.

      3. Set an alarm condition. Click Template, select the created static threshold template from the drop-down list, and set parameters, such as Alarm Clearance and Action Taken for Insufficient Data.

         

         Figure 3 Setting an alarm condition

         Table 2 Alarm condition parameters

         Category	Parameter	Description
         Alarm Template	-	Select the static threshold template you have created. If the existing templates do not meet your requirements, click Create Alarm Template to create one. For details, see Creating a Static Threshold Template.
         Trigger Condition	-	The system automatically imports the preset trigger condition in the template. Note that the condition cannot be modified.
         Advanced Settings	Alarm Clearance	An alarm will be cleared if the monitored object does not meet the trigger condition within the monitoring period. By default, metrics in only one period are monitored. You can set up to five monitoring periods.
         	Action Taken for Insufficient Data	Action to be taken when no metric data is generated or metric data is insufficient within the monitoring period. You can set this option based on your requirements. By default, metrics in only one period are monitored. You can set up to five monitoring periods. Options: Alarm, Insufficient data, Keep previous status, and Normal.

      4. Set alarm tags and annotations to group alarms.

         Click Add Tag or Add Annotation.

3. Click Create Now. As shown in the following figure, a threshold rule is created. Click to monitor the same metric of multiple resources.

   In the expanded list, if the metric data of a host meets the preset alarm condition, a threshold alarm is generated on the alarm page. To view the alarm, go to the AOM console and choose Alarm Center > Alarm List in the navigation pane.

   

   Figure 4 Creating a threshold rule

More Operations

After creating a threshold rule, perform the operations listed in Table 3 if needed.

Table 3 Related operations

Operation	Description
Editing a threshold rule	Click Edit in the Operation column.
Deleting threshold rules	To delete a threshold rule, click Delete in the Operation column. To delete one or more threshold rules, select the check boxes before them and click Delete above the rule list.
Starting or stopping a threshold rule	Click Start or Stop in the Operation column. Note Single-resource threshold rules cannot be started or stopped.
Searching for a threshold rule	You can search for a rule by rule name, description, or metric name. Simply enter a keyword in the search box in the upper right corner and click .
Viewing an alarm	When the metric value of a resource meets the threshold condition during the configured consecutive periods, the system reports a threshold alarm. In the navigation pane, choose Alarm Center > Alarm List to view the alarm.
Viewing an event	When no metric data of a resource is reported during the configured consecutive periods, the system reports an insufficient data event. In the navigation pane, choose Alarm Center > Event List to view the event.

last updated: 2024-05-06 02:45