編輯RecordingRule.yaml - Managed Service for Prometheus

本文介紹如何配置預彙總（Recording Rule）以及如何查看Recording Rule指標。

背景資訊

預彙總（Recording Rule）可以對落地的指標資料做二次開發。某些查詢可能需要在查詢端進行大量的計算，導致查詢端壓力過大，您可以配置預彙總規則將計算過程提前到寫入端，減少查詢端資源佔用，尤其在大規模叢集和複雜業務情境下可以有效降低PromQL的複雜度，從而提高查詢效能，解決使用者配置以及查詢慢的問題。

說明 Recording Rule的配置與開源Prometheus相同，以規則群組（Rule Group）的形式存在，每個規則群組可以有多條規則（Rules），彙總規則的名稱必須符合 Prometheus指標名稱規範。相同組中的規則以一定的間隔順序執行，預彙總後的指標按照新的規則名字存入遠端資料庫。

配置Recording Rule

登入ARMS控制台。
登入Prometheus控制台。
在左側導覽列單擊執行個體列表，進入可觀測監控 Prometheus 版的執行個體列表頁面。
在頁面左上方選擇目標地區，然後單擊需要配置Recording Rule的Prometheus執行個體名稱。
在左側導覽列的設定頁面單擊設定頁簽，然後單擊編輯RecordingRule.yaml。

在彈出的對話方塊，刪除預設範本並輸入預彙總規則，然後單擊儲存。

說明同一個叢集只需要配置一份RecordingRule.yaml，不同規則群組（Rule Group）的名字必須不同。

預彙總規則樣本：

groups:
  - name: apiserver_request_total
    interval: 60s
    rules:
      - record: job_instance_mode:apiserver_request_total:avg_rate5m
        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

參數	說明
groups	規則群組。一份RecordingRule.yaml可以配置多組規則群組。
name	規則群組名稱。規則群組名稱必須唯一。
interval	（可選）規則群組的執行循環。預設60s。
rules	規則。一個規則群組可以包含多條規則。
record	規則的名稱。彙總規則的名稱必須符合 Prometheus指標名稱規範。說明預彙總規則命名的推薦格式：`level:metric:operations` `level`：表示彙總層級，以及規則的輸出標籤。 `metric`：表示指標的名稱。 `operations`：應用於指標的巨集指令清單，最新的操作在前面。
expr	計算運算式。可觀測監控 Prometheus 版將通過該運算式計算得出預彙總指標。計算運算式必須符合PromQL。
labels	（可選）指標的標籤。

查看Recording Rule指標

方式一：從Grafana大盤查看

以管理員帳號登入本地Grafana系統。
在左側導覽列中選擇Explore。
在Explore右側選擇對應的Kubernetes叢集名稱，然後在Metrics右側輸入Recording Rule指標名稱查看該指標的資料詳情。

方式二：從Prometheus控制台查看

登入Prometheus控制台。
在左側導覽列單擊執行個體列表，進入可觀測監控 Prometheus 版的執行個體列表頁面。
在頁面左上方選擇目標地區，然後單擊需要查看Recording Rule指標的Prometheus執行個體名稱。
在左側導覽列的服務發現頁面，選擇指標頁簽，然後您可以在搜尋方塊中輸入對應的Recording Rule指標名稱來查看該指標的詳細資料。

Recording Rule支援Remote Write

可觀測監控 Prometheus 版的Recording Rule同開源Prometheus一樣，支援Remote Write功能。

登入ARMS控制台。
登入Prometheus控制台。
在左側導覽列單擊執行個體列表，進入可觀測監控 Prometheus 版的執行個體列表頁面。
在頁面左上方選擇目標地區，然後單擊需要配置Remote Write的Prometheus執行個體名稱。
在左側導覽列的設定頁面單擊設定頁簽，然後單擊編輯Prometheus.yaml。
在彈出的編輯Prometheus.yaml對話方塊中配置Remote Write。
說明配置Remote Write的方法與開源Prometheus配置方法相同。支援多組Remote Write配置，同時支援Write Relabel Config。
Remote Write配置同時對Agent和Recording Rule組件生效。若只需要將Recording Rule產生的指標遠程寫（Remote Write）到其他庫，可配置對應的Write Relabel Config。樣本如下：
```
remote_write:
  - url: "https://xxxx/api/v1/prom/write?db=dbname&u=username&p=password"    //遠程寫資料庫地址
    write_relabel_configs:
      - source_labels: [__name__]
        regex: job_instance_mode:apiserver_request_total:avg_rate5m
        action: keep
```
說明當前配置只會將Recording Rule指標（即job_instance_mode:apiserver_request_total:avg_rate5m）遠程寫（Remote Write）到其他庫。

Managed Service for Prometheus：編輯RecordingRule.yaml