術語注意事項

「name」、「type」、「kind」、「metric」和「resource」等字詞會以各種組合和與 Cloud Monitoring 相關的情況出現，且用法不一定一致。以下列舉一些常見的模式：

  • 在不同情境中，指標一詞可能會用來指稱下列任一項目：

    • 要評估的一般「項目」
    • 指標類型
    • 時間序列
    • 與指標類型相關聯的一組時間序列
    • 嵌入 TimeSeries 結構中的 Metric 結構

  • storage.googleapis.com/api/request_count 這類字串可能會被稱為下列任一項目：

    • 指標
    • 指標名稱
    • 指標類型
    • 指標類型名稱

  • gcs_bucket 這類字串可能會被稱為下列任一項目：

    • 資源名稱1
    • 受控資源
    • 受控資源類型
    • 受控資源名稱

1 REST API 參考資料也經常使用「資源名稱」一詞，但這通常與受監控的資源無關。如需這項術語的詳細說明，請參閱「資源名稱」。

本節將說明一些可能令人困惑的術語。

類型和名稱

指標類型和受控資源的描述元都包含名稱和類型。在一般用法中，這兩個詞彙經常可互換使用。

舉例來說，字串 storage.googleapis.com/api/request_count 是指標類型，但也稱為名稱或類型名稱。

如果您查看這個指標類型的描述元，會看到以下兩個鍵/值組合：name 和 type：

{
  "name": "projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count",
  ...
  "type": "storage.googleapis.com/api/request_count",
}

指標描述元中的 type 是字串，用於編碼產生資料的服務 (例如 storage.googleapis.com) 和所測量的內容 (api/request_count) 相關資訊。

在指標描述元中，name 的值是指標類型的完整修飾版本；name 值是 type 值，前面加上以下字串：

projects/[PROJECT_ID]/metricDescriptors/

受控資源也適用類似的模式。type 是某種資源類型的標籤，而 name 則由 type 值和以下字串開頭組成：

projects/[PROJECT_ID]/monitoredResourceDescriptors/

以下範例對應至受控資源清單中的 api 項目：

{
  "type": "api",
  ...
  "name": "projects/[PROJECT_ID]/monitoredResourceDescriptors/api"
}

專案中的 name 值完全可由 type 值預測，但兩者並不完全相同。不過，這些詞彙在一般討論中經常用得不夠精確。

指標種類和值類型

以下兩個術語也可能會與「指標類型」混淆：

  • 值類型
  • 指標種類

這些詞彙並非「指標類型」的替代詞彙。

「值類型」和「指標種類」會說明所收集的資料。這兩者都與程式設計概念「資料類型」相關。

  • 值類型會說明個別值。
  • 指標類型會說明值彼此的關聯方式。

詳情請參閱「指標種類與類型」。

資源名稱

透過在 type (或其他) 值前方加上字串，建立 name 值的模式，不僅適用於指標和監控資源類型，幾乎所有可產生可明確識別資料的內容都會顯示這項資訊。例如，MetricDescriptor 和 AlertPolicy 都遵循這個模式。

參考說明文件中通常會將 name 欄位的值描述為「資源名稱」：

API 參考資料中的資源名稱

以下是一些結構體的資源名稱和衍生方式範例：

  • 指標描述元：連結前置字元和 type 欄位的值：
    • 前置字串：projects/[PROJECT_ID]/metricDescriptors
    • type (範例)：storage.googleapis.com/api/request_count
    • name：projects/[PROJECT_ID]/metricDescriptors/storage.googleapis.com/api/request_count
  • 受控資源描述項：彙整前置字串和 type 欄位的值：
    • 前置字串：projects/[PROJECT_ID]/monitoredResourceDescriptors
    • type (範例)：api
    • name：projects/[PROJECT_ID]/monitoredResourceDescriptors/api
  • 警示政策：連結前置字串的值和產生的 ID
    • 前置字串：projects/[PROJECT_ID]/alertPolicies
    • 警報政策 ID：建立政策時產生的數字
    • name：projects/[PROJECT_ID]/alertPolicies/[ALERT_POLICY_ID]

「資源名稱」一詞是指服務 API 階層中的資源，與監控資源的概念毫無關聯。如要進一步瞭解 API 設計中的資源名稱，請參閱「資源名稱」。