指標命名慣例

Cloud Monitoring 中的標準化資源名稱、網域前置字元和標籤鍵，可讓您識別指標來源及定義自訂指標。您可以套用這些格式規則，為 Cloud Monitoring API 建立有效的指標類型和 LabelDescriptor 鍵。

指標資源名稱

指標類型的資源名稱由包含三個主要子結構的字串組成：

  • 特定專案的 ID。
  • 標記，一律設為 metricDescriptors，表示字串代表指標描述元。
  • 指標類型。

指標類型的資源名稱遵循以下模式：

projects/PROJECT_ID/metricDescriptors/METRIC_TYPE

子字串 METRIC_TYPE 是代表指標類型的 ID。這類廣告有多種格式，例如：

agent.googleapis.com/agent/api_request_count
compute.googleapis.com/firewall/dropped_bytes_count
istio.io/service/client/received_bytes_count
kubernetes.io/anthos/APIServiceOpenAPIAggregationControllerQueue1_adds

在指標描述元中，name 欄位會儲存指標類型的資源名稱，type 欄位則會儲存 METRIC_TYPE 子字串。

下表說明如何剖析資源名稱中包含的 METRIC_TYPE 子字串：

可能結構 說明
SERVICE_NAME 1.googleapis.com/PATH 2 Google Cloud 產品和服務的指標。如需這些指標的完整清單，請參閱 Google Cloud 指標。
agent.googleapis.com/SERVICE_NAME 1/PATH 2 在 Google Cloud 或 AWS 的 VM 執行個體上，執行 Monitoring 和 Logging 代理程式所產生的指標。如需這些指標的完整清單，請參閱「代理程式指標」。
kubernetes.io/anthos/PATH 2 GKE Enterprise 的指標，這項 Google Cloud服務可讓您在地端部署和雲端執行 Kubernetes 叢集。如需這些指標的完整清單，請參閱「Anthos 指標」。
aws.googleapis.com/SERVICE_NAME 1/PATH 2 Amazon Web Services 的指標。如需這些指標的完整清單，請參閱「AWS 指標」。
istio.io/PATH 2 Istio for Google Cloud 的指標。 如需這些指標的完整清單，請參閱 Istio 指標。
kubernetes.io/PATH 2 Google Kubernetes Engine 的指標。如需這些指標的完整清單，請參閱「Kubernetes 指標」。
knative.dev/PATH 2 Knative 的指標。如需這些指標的完整清單，請參閱「Knative 指標」。
external.googleapis.com/EXT_SERVICE/PATH 2
external.googleapis.com/prometheus/PATH 2		 第三方自訂指標，例如 Prometheus。這項開放原始碼監控工具通常與 Kubernetes 搭配使用。如要進一步瞭解這些指標，請參閱「外部指標」。這些指標類型只能在定義它們的專案中使用。
custom.googleapis.com/PATH 2
external.googleapis.com/user/PATH 2		 使用者定義的指標。 這些指標類型只能在定義指標類型的專案中使用。
logging.googleapis.com/PATH 2 Cloud Logging 的記錄指標。您可以使用預先定義的指標，也可以建立自訂指標。自訂指標只能在定義指標的專案中使用。

1 SERVICE_NAME 識別 Google Cloud 產品，例如 Compute Engine 的 compute。
2 PATH 識別產品中的指標，例如 instance/cpu/utilization。

指標類型和標籤的規則

這份清單列出建立自訂指標類型時應遵循的規則。與指標類型相關聯的標籤會指定為 LabelDescriptor 類型的鍵/值組合。鍵是標籤的名稱。

  • 指標類型

    • 在字串中使用大小寫字母 (A-Z、a-z)、數字 (0-9)、句號 (.)、底線 (_)、冒號 (:) 和連字號 (-)。
    • 使用正斜線 (/) 分隔路徑元素。
    • 每個路徑元素都必須以英文字母或數字開頭。
    • 指標類型字串的長度上限為 200 個字元。

  • 標籤鍵

    • 標籤鍵可使用小寫英文字母 (a-z)、數字 (0-9)、底線 (_) 和半形句號 (.)。
    • 標籤鍵開頭須為英文字母。
    • 標籤鍵的長度上限為 100 個字元。
    • 指標類型中的各個鍵均不得重複。
    • 每種指標類型最多只能有 30 個標籤。