用戶端指標說明

本頁面詳細說明 Spanner 提供的各項用戶端指標。如要進一步瞭解如何查看及管理用戶端指標,請參閱「查看及管理用戶端指標」。

用戶端指標提供用戶端對 Spanner 的 RPC 要求嘗試和作業延遲時間資訊。

嘗試是指從用戶端傳送至 Spanner 的單一 RPC 要求。如果要求失敗,用戶端可以多次嘗試。

作業代表所有 RPC 要求皆已完成,包括用戶端對 Spanner 執行的所有嘗試。當用戶端收到回應或用盡所有嘗試次數時,作業即完成。

RPC 要求會先到達 Google Front End (GFE),然後到達 Spanner API 前端 (AFE)。詳情請參閱「Spanner 要求中的延遲時間點」。

用戶端會根據 GFE 和 AFE 新增至回應標頭的時間資訊,計算 GFE 延遲時間和 AFE 延遲時間指標。如果嘗試在用戶端收到回應標頭前結束,用戶端就不會記錄該次嘗試的 GFE 或 AFE 延遲時間樣本。例如,當要求期限到期且用戶端傳回 DEADLINE_EXCEEDED 錯誤時,就會發生這種情況。而是會增加對應的連線錯誤計數指標。因此,GFE 和 AFE 延遲時間分布只會包含收到回應標頭的嘗試,即使許多嘗試逾時,也可能看起來正常。

用戶端只會記錄透過 GFE 傳送的要求。如果要求使用 DirectPath (directpath_used 為 true),用戶端不會記錄該要求的 GFE 延遲時間或 GFE 連線錯誤計數。

這些指標包括 DISTRIBUTION 和 INT64 指標值類型。詳情請參閱「值類型和指標種類」。

您可以使用 Java、Go、Node.js 和 Python 的 Spanner 用戶端程式庫,存取用戶端指標。

用戶端指標支援 google.spanner.v1.Spanner RPC API 中的所有 Spanner 方法。

所有用戶端指標都包含下列維度:

  • project ID: Google Cloud 專案 ID。
  • instance ID:Spanner 執行個體 ID。
  • database ID:Spanner 資料庫 ID。
  • location:發布用戶端指標的 Google Cloud 區域。如果應用程式部署在 Google Cloud以外,指標會發布至 global 區域。
  • method:RPC 方法名稱,例如 spanner.commit。
  • status:RPC 狀態,例如 OK 或 INTERNAL。
  • client_name:程式庫名稱和版本,例如 spanner-java/6.70.1。
  • directpath_enabled:用戶端程式庫是否設為直接存取 Spanner,不經過前端。
  • directpath_used:目前的要求是否直接傳送至 Spanner,不經過前端。如果 directpath_enabled 為 true,false 值表示要求已改用標準路徑,透過 GFE 傳送。

AFE 連線錯誤次數

AFE 連線能力錯誤計數指標會記錄用戶端在回應標頭中,未收到 Spanner AFE 時間資訊的嘗試次數。舉例來說,如果要求未到達 AFE,或在用戶端收到回應標頭前逾時,就會發生這種情況。「AFE latencies」(AFE 延遲時間) 指標不會記錄這些嘗試的樣本。

AFE 連線錯誤計數指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value type:INT64

AFE 延遲時間

AFE 延遲時間指標會測量 Spanner AFE 收到用戶端 RPC 要求,到 Spanner AFE 開始寫入回應之間的時間。

用戶端會根據回應標頭中的時間資訊計算這個值。如果嘗試在用戶端收到回應標頭前結束,用戶端不會記錄樣本,而是會增加 AFE 連線錯誤計數指標。

AFE 延遲時間指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/afe_latencies
  • Metric value type:DISTRIBUTION

嘗試次數

「嘗試次數」指標會記錄嘗試次數。attempt_count 值通常與 operation_count 值相同。如果用戶端收到暫時性錯誤,attempt_count 值會是所有嘗試的總和。

「嘗試次數」指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/attempt_count
  • Metric value type:INT64

嘗試延遲時間

「嘗試延遲時間」指標會測量單一 RPC 嘗試的持續時間,從用戶端傳送要求到嘗試成功或失敗為止。attempt_latencies 值通常與 operation_latencies 值相同。如果用戶端收到暫時性錯誤,則 operation_latencies 值是所有 attempt_latencies 值的總和。

「嘗試延遲時間」指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/attempt_latencies
  • Metric value type:DISTRIBUTION

GFE 連線錯誤次數

GFE 連線能力錯誤計數指標會記錄用戶端在回應標頭中,未收到 GFE 時間資訊的嘗試次數。舉例來說,如果要求未傳送至 GFE,或在用戶端收到回應標頭前逾時,就會發生這種情況。GFE 延遲時間指標不會記錄這些嘗試的樣本。

GFE 連線錯誤計數指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value type:INT64

GFE 延遲時間

GFE 延遲時間指標會評估 GFE 收到用戶端 RPC 要求,到 GFE 收到第一個回應位元組之間的時間。這項指標不含任何 TCP 或 TLS 握手所需的時間。

用戶端會根據回應標頭中的時間資訊計算這個值。如果嘗試在用戶端收到回應標頭前結束,用戶端不會記錄樣本,而是會增加 GFE 連線錯誤計數指標。如果 GFE 連線錯誤次數增加,即使 GFE 延遲時間看起來正常,也不代表延遲時間很短。

GFE 延遲時間指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/gfe_latencies
  • Metric value type:DISTRIBUTION

作業數

作業計數指標會記錄每 60 秒執行的作業數量。

「作業數量」指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/operation_count
  • Metric value type:INT64

作業延遲時間

作業延遲時間指標會測量作業從用戶端 gRPC 層到 Spanner 再回到用戶端的來回時間。

「作業延遲時間」指標具有下列屬性:

  • Metric name:spanner.googleapis.com/client/operation_latencies
  • Metric value type:DISTRIBUTION

後續步驟