(New) Using Prometheus to Monitor ECS Metrics

Constraints

The ECS must be in the same region as the AOM console.

Procedure

1. Installing UniAgent on the ECS: Install UniAgent on the host in the region where the AOM console is located to centrally manage metric collection plug-ins.
2. Creating a Host Group: Create a host group for better host management and more efficient data collection.
3. Connecting the ECS to AOM: Connect an ECS to AOM. Then you can install Node Exporter and configure collection tasks for the host group. The collected metrics will be stored in the Prometheus instance for ECS for easy management.
4. Setting a Metric Alarm Rule: Create an alarm rule for the ECS metric. If the metric data meets the alarm condition, an alarm will be generated.

Preparation

• You have purchased an ECS. For details, see Purchasing and Using a Linux ECS. If you already have an ECS, skip this step.
• You have subscribed to AOM 2.0 and granted permissions.

Installing UniAgent on the ECS

1. Log in to the AOM 2.0 console.
2. In the navigation pane, choose Settings > Collection Settings > UniAgent Installation and Configuration, and click Go to New Version in the upper right corner.
3. On the displayed page, check the UniAgent status of the ECS.
   • If the UniAgent status is Running, UniAgent has been installed. In this case, go to Creating a Host Group.
   • If the UniAgent status is Abnormal, UniAgent is abnormal. In this case, contact technical support.
   • If the UniAgent status is Installing, UniAgent is being installed. Wait until the UniAgent is installed.
   • If the UniAgent status is Installation failed or Not installed, UniAgent fails to be installed or is not installed on the host. In this case, install it.

4. Click Install UniAgent. On the displayed page, set related parameters.
   Figure 1 Installing UniAgent
   

   Table 1 Installation parameters

   Parameter	Description	Example
   Server Region	Options: Current region and Outside current region. In this example, select Current region. Current region: The network between AOM and the server in the current region is connected.	Current region
   Server Type	Options: ECSs and Other Servers. Select ECSs. ECSs: hosts managed by the ECS service.	ECSs
   Installation Mode	Option: CLI. You need to remotely log in to the server to run the installation command provided on the console.	CLI
   OS	Option: Linux.	Linux
   UniAgent Version	Select a UniAgent version. The latest version is selected by default.	Latest version
   Copy and Run Installation Command	Click Copy to copy the installation command.	Copy the Linux installation command.

5. Log in to the ECS and run the Linux installation command copied in 4 as the root user.
6. Check the UniAgent status in the UniAgent list. If the UniAgent status is Running, the installation is successful.

Creating a Host Group

You can create host groups of the IP address and custom identifier types. In this example, select the IP address type.

1. In the navigation pane, choose Settings > Collection Settings > Host Groups and click Create Host Group.
2. On the displayed page, set related parameters.

   Table 2 Parameters

   Parameter	Description	Example
   Host Group	Name of a host group. Enter 1 to 64 characters. Do not start with a period (.) or underscore (_) or end with a period. Only letters, digits, hyphens (-), underscores, and periods are allowed.	aom-ecs
   Host Group Type	Type of the host group. Options: IP and Custom identifier. In this example, select IP.	IP
   Host Type	Host type. Default: Linux.	Linux
   Remark	Host group remarks. Enter up to 1,024 characters. In this example, leave this parameter blank.	-

3. In the host list, select one or more hosts to add to the group and click OK.

Connecting the ECS to AOM

1. Log in to the AOM 2.0 console.
2. In the navigation pane, choose Access > Access Center. Click Experience the new version in the upper right corner of the page.
3. Locate the Elastic Cloud Server (ECS) card under Running environments and click Ingest Metric (AOM) on the card.
4. Set parameters for connecting to the ECS.
   1. Select a Prometheus instance.
      1. Instance Type: Prometheus for ECS is selected by default and cannot be changed.
      2. Instance Name: Click Create Instance to create an instance by referring to Table 3. Then select the created instance from the drop-down list.

         Table 3 Parameters for creating a Prometheus instance for ECS

         Parameter	Description	Example
         Instance Name	Prometheus instance name. Enter a maximum of 100 characters and do not start or end with an underscore (_) or hyphen (-). Only letters, digits, underscores, and hyphens are allowed.	mon_ECS
         Enterprise Project	Enterprise project. If Enterprise Project is set to All on the global settings page, select an enterprise project from the drop-down list here. If you have already selected an enterprise project on the global settings page, this option will be grayed and cannot be changed.	default
         Instance Type	Type of a Prometheus instance.	Prometheus for ECS

   2. Select a host group.

      In the host group list, select the host group created in Creating a Host Group.

   3. Configure the collection.
      Under Configure Collection, set parameters by referring to the following table.

      Table 4 Collection configuration

      Category	Parameter	Description	Example
      Basic Settings	Configuration Name	Name of a metric ingestion rule. Enter up to 50 characters starting with a letter. Only letters, digits, underscores (_), and hyphens (-) are allowed.	ecs-rule
      Metric Collection Rule	Metric Collection Interval (s)	Interval for collecting metrics, in seconds. Options: 10, 30, and 60 (default).	60
      	Metric Collection Timeout (s)	Timeout period for executing a metric collection task, in seconds. Options: 10, 30, and 60 (default). The timeout period cannot exceed the collection interval.	60
      	Executor	User who executes the metric ingestion rule, that is, the user of the selected host group. Default: root.	root
      Other	Custom Dimensions	Dimensions (key-value pairs) added to specify additional metric attributes. You can click Add Dimension to add multiple custom dimensions (key-value pairs). In this example, leave this parameter blank.	-
      	Import ECS Tags as Dimensions	This function is disabled by default. If it is enabled, ECS tags (key-value pairs) will be written to metric dimensions and tag changes will be synchronized to AOM.	Disable

5. After the configuration is complete, click Next. The ECS is then connected.

Setting a Metric Alarm Rule

Metric alarm rules can be created in the following modes: Select from all metrics and PromQL.

The following describes how to create an alarm rule when Configuration Mode is set to Select from all metrics.

1. In the navigation pane, choose Alarm Management > Alarm Rules. Then, click Create.
2. Set basic information about the alarm rule by referring to Table 5.

   Table 5 Basic information

   Parameter	Description	Example
   Rule Name	Name of the rule. Enter a maximum of 256 characters and do not start or end with any special character. Only letters, digits, underscores (_), and hyphens (-) are allowed.	monitor_ecs
   Enterprise Project	Select the required enterprise project. The default value is default.	default
   Description	Description of the rule. Enter up to 1,024 characters. In this example, leave this parameter blank.	-

3. Set the detailed information about the alarm rule.
   1. Rule Type: Metric alarm rule.
   2. Configuration Mode: Select from all metrics. Then you can set alarm conditions for different types of resources.
   3. Select the target Prometheus instance from the drop-down list. In this example, select the instance created in 4.a.ii.
   4. Set alarm rule details. Table 6 describes the parameters.

      After the setting is complete, the monitored metric data is displayed in a line graph above the alarm conditions. You can click Add Metric to add more metrics and set the statistical period and detection rules for them.

      Figure 2 Setting alarm rule details
      

      Table 6 Alarm rule details

      Parameter	Description	Example
      Multiple Metrics	Calculation is performed based on the preset alarm conditions one by one. An alarm is triggered when one of the conditions is met.	Multiple Metrics
      Metric	Metric to be monitored. Click the Metric text box. In the resource tree on the right, select a target metric by resource type.	node_network_up
      Statistical Period	Interval at which metric data is collected.	1 minute
      Conditions	Metric monitoring scope. If this parameter is left blank, all resources are covered. In this example, leave this parameter blank.	-
      Grouping Condition	Aggregate metric data by the specified field and calculate the aggregation result.	Not grouped
      Rule	Detection rule of a metric alarm, which consists of the statistical mode (Avg, Min, Max, Sum, and Samples), determination criterion (≥, ≤, >, and <), and threshold value.	Avg > 1
      Trigger Condition	When the metric value meets the alarm condition for a specified number of consecutive periods, a metric alarm will be generated.	3
      Alarm Severity	Severity of a metric alarm. : a critical alarm. : a major alarm. : a minor alarm. : a warning.

4. Click Advanced Settings and set information such as Check Interval and Alarm Clearance. For details about the parameters, see Table 7.

   Table 7 Advanced settings

   Parameter	Description	Example
   Check Interval	Interval at which metric query and analysis results are checked.	Custom interval: 1 minute
   Alarm Clearance	The alarm will be cleared when the alarm condition is not met for a specified number of consecutive periods.	1
   Action Taken for Insufficient Data	Action to be taken if there is no or insufficient metric data within the monitoring period. Enable this option if needed.	Enabled: If the data is insufficient for 1 period, the status will change to Insufficient data and an alarm will be sent.
   Alarm Tag	Click to add an alarm tag. It is an alarm identification attribute in the format of "key:value". It is used in alarm noise reduction scenarios. In this example, leave this parameter blank. For details, see Alarm Tags and Annotations.	-
   Alarm Annotation	Click to add an alarm annotation. Alarm non-identification attribute in the format of "key:value". It is used in alarm notification and message template scenarios. In this example, leave this parameter blank. For details, see Alarm Tags and Annotations.	-

5. Set an alarm notification policy. For details, see Table 8.
   Figure 3 Setting an alarm notification policy
   

   Table 8 Alarm notification policy parameters

   Parameter	Description	Example
   Notify When	Set the scenario for sending alarm notifications. By default, Alarm triggered and Alarm cleared are selected. Alarm triggered: If the alarm trigger condition is met, the system sends an alarm notification to the specified personnel by email or SMS. Alarm cleared: If the alarm clearance condition is met, the system sends an alarm notification to the specified personnel by email or SMS.	Retain the default value.
   Alarm Mode	Direct alarm reporting: An alarm is directly sent when the alarm condition is met. If you select this mode, set an interval for notification and specify whether to enable an action rule. Frequency: frequency for sending alarm notifications. Select a desire value from the drop-down list. Action Rule: If you enable this function, the system sends notifications based on the associated SMN topic and message template. If there is no alarm action rule you want to select, click Create Rule in the drop-down list to create one. For details, see Setting an Alarm Action Rule.	Alarm Mode: Select Direct alarm reporting. Frequency: Select Once. Action Rule: Select Mon_aom.

6. Click Confirm. Then click View Rule to view the created rule.

   In the expanded list, if a metric value meets the configured alarm condition, a metric alarm is generated on the alarm page. To view the alarm, choose Alarm Management > Alarm List in the navigation pane. If a metric value meets the preset notification policy, the system sends an alarm notification to the specified personnel by email or SMS.

   Figure 4 Creating a metric alarm rule
   

Related Information

After an alarm rule is configured, you can perform the following operations if needed:

• Choose Alarm Management > Alarm List to check alarms. For details, see Checking Alarms.
• Create metric alarm rules using other methods. For details, see Creating a Metric Alarm Rule.