值類型和指標種類

在討論指標模型時，指標類型一節會概略說明描述指標類型的屬性。本節將進一步討論其中兩個屬性：

  • 值類型
  • 指標種類

值類型

值類型是評估資料的資料類型。每個時間序列都會記錄資料點的值類型 (類型 ValueType)。

  • 對於每次只包含單一值的評估，例如布林值和數值資料，值類型會說明資料的儲存方式：

    • BOOL，布林值
    • INT64，64 位元整數
    • DOUBLE，雙精度浮點
    • STRING，字串

  • 對於分佈測量，值不是單一值，而是一組值。分布量測值的值類型為 DISTRIBUTION。

    分布包含統計資料，可用於匯總一組值。分布中的值包括平均值、計數、最大值和其他統計資料，這些值是針對一組值計算而得。分布也可以包含直方圖，用來表示值如何分布在一系列範圍內。

延遲指標通常會以分佈方式擷取資料。如要進一步瞭解發布項目，請參閱 Distribution 參考頁面。如要瞭解如何將這些指標繪製成圖表，請參閱「分佈指標」。

指標種類

每個時間序列都包含資料點的指標類型 (類型 MetricKind)。指標資料的類型會說明如何解讀彼此相關的值。Cloud Monitoring 指標有三種：

  • 指標指標，其中的值會測量特定時間點。舉例來說，用於評估 CPU 使用率的指標是度量儀指標，每個點都會記錄量測時的 CPU 使用率。另一個量測指標的範例是目前的溫度。

  • 差異指標，其中的值會評估時間間隔的變化。對於讀取作業，時間間隔為半開啟，會排除開始時間，但包含結束時間：(startTime, endTime]。舉例來說，用於評估要求次數的指標是差異指標，每個值都會記錄從起始時間到結束時間 (含結束時間) 期間收到的請求次數。

  • 累積指標，其值會隨著時間不斷增加。舉例來說，「已傳送位元組」指標可能會累積；每個值都會記錄服務在該時間點傳送的位元組總數。

支援的組合

並非所有指標種類和值類型組合都合理。舉例來說，您不會看到包含布林資料的差異指標。有些組合搭配起來會很合理。

下表列出支援的指標種類和值類型：

值類型 GAUGE DELTA 累積4
BOOL 是 否 否
INT64 是 是1 是
DOUBLE 是 是1 是
STRING 是1 否 否
DISTRIBUTION 是2 是1、3 是

1 自訂指標不允許使用此組合，custom.googleapis.com。
2 記錄式指標不允許使用這個組合。詳情請參閱「設定以分布為準的記錄指標」。
3 這是日誌指標 logging.googleapis.com/user 與值類型 DISTRIBUTION 唯一允許的組合；如需更多資訊，請參閱 Logging API LogMetric 參考資料中的 metricDescriptor 欄位。
4 累積指標無法直接用於 Monitoring 中的圖表或警示，但可以匯總為可用於這些方式的非累積指標。詳情請參閱「類型、類別和轉換」。

此外，如果您要自行建立指標，請務必只使用有效的值類型和指標種類組合。

模擬字串值自訂指標

系統不支援自訂指標中的字串值，但您可以透過下列方式複製字串值指標功能：

  • 使用 INT64 值建立 GAUGE 指標，做為對應至字串值的列舉。在查詢指標時，將排序為外部轉譯為字串值。
  • 請使用 BOOL 值和標籤建立 GAUGE 指標，其中標籤的值為您要監控的字串之一。使用布林值表示值是否為有效值。

舉例來說，假設您想建立名為「status」的字串值指標，並提供「OK」、「OFFLINE」或「PENDING」等選項。您可以使用名為 status_value 的標籤建立 GAUGE 指標。每次更新都會寫入三個時間序列，每個 status_value (OK、OFFLINE 或 PENDING) 各一個，值為 1 表示「true」，0 表示「false」。