本頁面提供記錄指標的概念總覽。這些指標有助於觀察大量記錄項目的趨勢和模式。
記錄指標簡介
記錄指標是從記錄項目內容衍生的 Cloud Monitoring 指標。舉例來說，您可以使用記錄指標計算含有特定訊息的記錄項目數量，或擷取記錄項目中記錄的延遲時間資訊。您可以在 Cloud Monitoring 圖表中顯示記錄指標，並透過快訊政策監控這些指標。
記錄指標可套用至專案層級或記錄檔儲存空間層級。如果您使用匯總接收器將記錄項目轉送至記錄檔值區，或是將記錄項目從一個專案轉送至另一個專案的記錄檔值區，值區專屬記錄指標就非常實用。詳情請參閱本頁面「記錄指標來源」一節。
記錄指標的時間序列值判定方式
本節簡要說明如何判斷計數器類型記錄指標的時間序列值。本文也說明記錄指標的時間序列為何可能出現間隙。分布值記錄指標的程序也類似。
如果是計數器類型的記錄指標，Logging 會執行下列動作：
這項服務會建立一或多個資料串流，並管理每個串流的一組記憶體內計數器。
每個指標和資源標籤組合的專屬值，都會產生一個串流。每個記憶體內計數器都適用於不同的時間間隔，但每個計數器都會記錄符合篩選條件的記錄項目數量，以及與間隔相符的時間戳記。
每分鐘，記錄後端都會針對每個串流，使用記憶體內計數器的值，判斷如何更新 Cloud Monitoring 管理的時間序列。
如果有五個資料串流，則表示有五個時間序列由監控服務管理。您可以繪製這些時間序列的圖表。您也可以建立警告政策來監控這些時間序列。
範例：零值如何導致資料缺口
請參考下列時間序列：
Example time series: (T1, -), (T2, -), (T3, 0), (T4, 1), (T5, 0), (T6, -)
在上述運算式中，(T1, -) 表示時間 T1 沒有寫入任何值。這表示時間序列中的值有缺漏。相反地，(T3, 0) 表示時間序列在時間 T3 的值為零。
對於每個串流，記錄檔指標的後端系統會使用下列規則，判斷要寫入 Monitoring 儲存時間序列的值：
如果間隔的匯總計數不為零，該值會寫入時間序列。
在範例時間序列中，只有間隔
T4具有非零值。1值表示時間戳記對應至T4間隔的記錄項目符合記錄指標的篩選條件。如果某個時間間隔的匯總計數為零，且相鄰間隔的值不為零，系統就會在時間序列中寫入零值。
在範例時間序列中，時間
T3的匯總計數為零。不過，由於在T4時間點，匯總計數不為零，因此系統會寫入零值。同樣地，在時間T5，匯總計數為零。由於前一個間隔的值不為零，因此系統會將零值寫入時間序列。否則，系統不會更新時間序列，且間隔會出現資料缺口。
在範例時間序列中，間隔
T1、T2和T6沒有任何值。在這些間隔中，匯總計數為零，相鄰間隔的計數也為零。
處理遲到和未來的記錄項目
如果記錄項目抵達時的時間戳記屬於已處理的間隔，Logging 後端會產生歷來資料。系統會使用歷來資料更新先前寫入的計數。
如果記錄項目抵達時的時間戳記是未來時間，記錄後端會累計這些計數。在時間序列中，如果記錄項目的時間戳記對應至目前間隔，就會計入。
記錄指標的來源
您可以使用 Cloud Logging 定義的指標收集一般用量資訊，也可以定義自己的記錄指標，擷取應用程式或業務專屬的資訊。
記錄指標可套用至單一 Google Cloud 專案或記錄 bucket。您無法為其他 Google Cloud 資源 (例如 Cloud Billing 帳戶或機構) 建立記錄指標。
如要瞭解以專案為準的記錄指標與以 bucket 為準的記錄指標有何差異，請參閱「以 bucket 為準的記錄指標」。
系統定義的指標
記錄功能提供一組用量指標，例如專案記錄 bucket 中儲存的記錄項目數量，或是匯出的位元組數。如需系統定義指標的完整清單，請參閱Google Cloud 指標：記錄。
系統定義的記錄指標適用於專案層級。
如果符合下列所有條件，記錄路由器就會計入記錄項目：
- 記錄項目會通過定義記錄指標的專案記錄接收器。
記錄項目會儲存在記錄檔值區中。記錄檔 bucket 可位於任何專案中。
舉例來說，假設專案
A有一個記錄接收器，目的地是專案B。此外，也假設專案B中的記錄接收器會將記錄項目轉送至記錄 bucket。在這個情境中，從專案A轉送至專案B的記錄項目，會計入專案A的系統定義記錄指標。這些記錄項目也會計入專案的系統定義記錄指標。B'
使用者定義的指標
您可以建立使用者定義的記錄指標，追蹤對專案而言重要的其他指標。舉例來說，您可以透過建立記錄指標，計算與指定篩選條件相符的記錄項目數量。
根據預設，使用者定義的記錄指標是根據 Logging API 為 Google Cloud 專案接收的所有記錄檔計算，不論Google Cloud 專案是否套用任何納入篩選器或排除篩選器。
您也可以在 Google Cloud 專案中，為特定記錄檔值區建立使用者定義的記錄指標。系統會根據所有要傳送至該值區的記錄，計算值區範圍的記錄指標，無論這些記錄的來源為何。詳情請參閱「記錄值區的記錄指標」。
如果符合下列所有條件，記錄路由器就會計入記錄項目：
- 已在定義記錄指標的專案中啟用帳單功能。
- 如果是值區範圍指標，記錄項目會儲存在定義記錄指標的記錄檔值區中。
- 如果是專案範圍指標，記錄項目會通過定義記錄指標的專案記錄接收器。
記錄指標的資料類型
記錄指標可從記錄中擷取資料，建立下列類型的指標：
- 計數器：這類指標會計算特定時間範圍內，符合指定篩選條件的記錄項目數量。如要追蹤記錄中值或字串的出現次數，請使用計數器。
- 分布：這些指標也會計算值，但會將計數收集到值範圍 (直方圖值區) 中。如要擷取延遲時間等值，請使用分配情形。
- 布林值：這些指標會擷取記錄項目是否符合指定篩選條件。