Ingesting Blackbox Metrics to AOM

Prerequisites

• The UniAgent has been installed and is running.
• You have created a common Prometheus instance.
• You have switched to the new access center.

Connecting Blackbox Exporter to AOM

1. Log in to the AOM 2.0 console.
2. In the navigation pane, choose Access Center > Access Center, filter the Blackbox card under Self-built middleware, and click Ingest Metric (AOM).
3. On the displayed page, set parameters.
   1. Set the Prometheus instance.
      1. Instance Type: Select a Prometheus instance type. Options: Prometheus for ECS and Common instance.

         (Currently, Prometheus instances for ECS cannot be created. You can only select the Prometheus instances for ECS created earlier.)

      2. Instance Name: Select a Prometheus instance from the drop-down list.

         You can click View Instance to go to the details page of the selected instance. If no Prometheus instance is available, click Create Instance to create a common Prometheus instance.

   2. Click Next to install the plug-in and test the connectivity.
      1. Set the parameters for installing the plug-in by referring to Table 1.

         Table 1 Parameters for installing the collection plug-in

         Operation	Parameter	Description
         Basic settings	Ingestion Rule Name	Name of a custom metric ingestion rule. Enter 1 to 50 characters starting with a letter. Only letters, digits, underscores (_), and hyphens (-) are allowed.
         Set Collection Plug-in	OS	Operating system of the host. Only Linux is supported.
         	Collection Plug-in	The default value is Blackbox Exporter. Select a plug-in version.
         Select Server to Install Plug-in	Select Server	Click Select Server to select a running server to configure a collection task and install Exporter. On the Select Server page, search for servers by server ID, name, status, or IP address. Ensure that the UniAgent of the selected server is running. Otherwise, no data can be collected. If no server meets your requirements, it is possible that the UniAgent has not been installed. In that case, install UniAgent. In addition, ensure that the UniAgent version is 1.1.3 or later. Upgrade UniAgent when necessary.
         Connect Blackbox Instance	Blackbox Config File Path	Path for storing the blackbox configuration file on the server where the metric collection plug-in is installed. Only letters, digits, hyphens (-), underscores (_), slashes (/), periods (.), and colons (:) are allowed. Example: /opt/blackbox.yml For details, see Blackbox Exporter Configuration Guide.

      2. Click Install & Test Collection Plug-in to deliver the Exporter installation task.
         • After the plug-in is installed, click Next.
         • Click View Log to view Exporter installation logs if the installation fails.
   3. Set an ingestion rule.
      Set a metric ingestion rule by referring to Table 2.

      Table 2 Parameters for setting a metric ingestion rule

      Operation	Parameter	Description
      Metric Collection Rule	Metric Collection Interval (s)	Interval for collecting metrics, in seconds. Options: 10, 30, and 60 (default).
      	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.
      	Executor	User who executes the metric ingestion rule, that is, the user of the selected server. By default, the executor is root.
      Other	Custom Dimensions	Dimensions (key-value pairs) added to specify additional metric attributes. You can click Add Dimension to add up to 10 custom dimensions (key-value pairs). Key: key of the additional attribute of a metric. Only letters, digits, and underscores (_) are allowed. Each name must start with a letter or underscore. Each key must be unique. Value: corresponds to the key of the additional attribute of a metric. The following characters are not allowed: &|><$;'!-() Example: Set the key to app and value to abc.

      After the metric collection rule parameters are configured, you can click YAML to view the configuration data in YAML format.

      

4. Click Next to connect Blackbox Exporter.

   Go to the Access Management page to view and manage the ingestion configuration of the Exporter. For details, see Managing Metric and Log Ingestion. Or go to the Metric Browsing page to analyze metrics. For details, see Observability Metric Browsing.