Configuring a Recording Rule

Prerequisite

Both your service and CCE cluster have been connected to a Prometheus instance for CCE. For details, see Prometheus Instance for CCE.

Configuring a Recording Rule

1. Log in to the AOM 2.0 console.
2. In the navigation pane on the left, choose Prometheus Monitoring > Instances.
3. In the instance list, click a Prometheus instance for CCE.
4. In the navigation pane on the left, choose Settings. In the Recording Rules area, click Edit RecordingRule.yaml.
5. In the dialog box that is displayed, delete the default content and enter a custom recording rule.
   NOTE:

   Only one RecordingRule.yaml file needs to be configured for a cluster. Each rule group name must be unique.

   Figure 1 Configuring a recording rule
   

   Table 1 Recording rule parameters

   Parameter	Description
   groups	Rule group. You can set multiple rule groups in one RecordingRule.yaml file.
   name	Rule group name. Each rule group name must be unique.
   interval	(Optional) Execution interval of a rule group. The default value is 60s.
   rules	Rule. A rule group can contain multiple rules.
   record	Name of a rule. The name must comply with Prometheus metric name specifications.
   expr	Calculation expression. It is used to calculate metric values. It must comply with PromQL requirements.
   labels	(Optional) Label of a metric.

   Example of a recording rule:

   groups:
     - name: apiserver_request_total
       interval: 60s
       rules:
         - record: apiserver_request_rate
           expr: avg by (job, instance, mode) (rate(apiserver_request_total[5m]))
           labels:
             team: operations
         - record: job:apiserver_request_total:sum_rate10m
           expr: sum by (job)(rate(apiserver_request_total[10m]))
           labels:
             team: operations

6. Click OK.

Viewing Recording Rule Metrics

After a recording rule is configured, you can view its metrics on the Metric Browsing page of AOM or using Grafana.

Method 1: Viewing Metrics on the Metric Browsing Page of AOM

1. On the Metric Browsing page, select a Prometheus instance for which a recording rule has been configured from the drop-down list.
2. Click All metrics and enter the name of a recording rule metric in the search box to view its details.

Method 2: Viewing Metrics Using Grafana

For details, see Viewing Prometheus Instance Data Through Grafana.