標籤指標

Google Distributed Cloud (GDC) 實體隔離方案中的 MonitoringTarget 自訂資源可讓您為抓取的指標加上標籤,區分指標特徵及篩選時間序列資料。除了收集指標之外,您還可以設定重新標籤規則,將指標轉送至其他專案、新增自訂鍵/值標籤,或在擷取前重新命名指標。

每個不重複的鍵/值標籤組合都會建立新的時間序列,這可能會大幅增加資料儲存空間。請避免將標籤用於具有多個可能值的高基數維度,例如使用者 ID 或電子郵件地址。如要進一步瞭解指標重新標籤,請參閱「Prometheus 重新標籤的運作方式」。

事前準備

如要管理 MonitoringTarget 自訂資源,您必須具備必要權限。

要求 IAM 組織角色

請與 IAM 機構組織管理員聯絡,要求下列角色:

  • MonitoringTarget PA 建立者 (monitoringtarget-pa-creator):建立 MonitoringTarget 自訂資源。
  • MonitoringTarget PA 編輯者 (monitoringtarget-pa-editor):編輯或修改 MonitoringTarget 自訂資源。
  • MonitoringTarget PA 檢視者 (monitoringtarget-pa-viewer~): viewMonitoringTarget` 自訂資源。

要求 IAM 專案角色

請與 IAM 專案管理員聯絡,要求下列角色:

  • MonitoringTarget 編輯者 (monitoringtarget-editor):編輯或修改專案命名空間中的 MonitoringTarget 自訂資源。
  • MonitoringTarget 檢視者 (monitoringtarget-viewer):查看專案命名空間中的 MonitoringTarget 自訂資源。

將指標傳送至其他專案

容器作者可以編寫程式碼,將特定指標傳送至其他專案,甚至是他們不擁有的專案。如要將指標傳送至特定專案,請在程式碼中為指標新增 _gdch_project 標籤,並將其值設為目的地專案名稱。

或者,您也可以使用 MonitoringTarget 自訂資源,將「所有」收集到的指標資料傳送至其他專案。在 metricsRelabelings 欄位中,將 _gdch_project 標籤設為目標標籤,並以新專案名稱做為替換值。

下列程式碼範例說明如何在 MonitoringTarget 自訂資源中設定 _gdch_project 目標標籤,將指標傳送至名為 another-project-name 的專案:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  # [...]
  podMetricsEndpoints:
    # [...]
    metricsRelabelings:
      - action: replace
        targetLabel: _gdch_project
        replacement: another-project-name
      # [...]

更改下列內容:

  • PROJECT_NAMESPACE:專案命名空間。
  • MONITORING_TARGET_NAME:MonitoringTarget 定義檔案的名稱。

為指標新增標籤

標籤可識別指標特徵,有助於觀測及監控。您可以新增標籤,讓抓取的容器一開始不會公開。在 MonitoringTarget 自訂資源中,將新標籤設為目標,並提供替換值。這個鍵/值組合會新增至資源收集的所有指標。

下列程式碼範例說明如何設定 my_new_label 目標標籤,並在 MonitoringTarget 自訂資源中將其值設為 my_label_value:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  # [...]
  podMetricsEndpoints:
    # [...]
    metricsRelabelings:
      - action: replace
        targetLabel: my_new_label
        replacement: my_label_value
      # [...]

更改下列內容:

  • PROJECT_NAMESPACE:專案命名空間。
  • MONITORING_TARGET_NAME:MonitoringTarget 定義檔案的名稱。

重新命名指標

您可以使用 MonitoringTarget 資源重新命名容器的指標。在 metricsRelabelings 欄位中設定原始指標名稱和替代名稱。原始名稱會視為規則運算式 (regex),並由新名稱取代。

下列程式碼範例說明如何將 MonitoringTarget 自訂資源中的 cpu_usage 指標名稱 (規則運算式) 替換為 cpu_usage_new_name:

apiVersion: monitoring.gdc.goog/v1
kind: MonitoringTarget
metadata:
  # Choose the same namespace as the workload pods.
  namespace: PROJECT_NAMESPACE
  name: MONITORING_TARGET_NAME
spec:
  # [...]
  podMetricsEndpoints:
    # [...]
    metricsRelabelings:
      - action: replace
        regex: cpu_usage
        replacement: cpu_usage_new_name
        sourceLabels: [__name__]
        targetLabel: __name__
      # [...]

更改下列內容:

  • PROJECT_NAMESPACE:專案命名空間。
  • MONITORING_TARGET_NAME:MonitoringTarget 定義檔案的名稱。