用戶端指標說明

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

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

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

作業代表所有 RPC 要求的完成情況，包括用戶端對 Spanner 進行的所有嘗試。當用戶端收到回應或所有嘗試都已用盡時，作業即完成。

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

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

您可以使用 Java 或 Go 適用的 Spanner 用戶端程式庫存取用戶端指標。

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

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

  • project ID：專案 ID。 Google Cloud
  • 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。

AFE 連線錯誤計數

AFE 連線錯誤計數指標會記錄無法連上 Spanner AFE 的 RPC 要求數量。

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

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

AFE 延遲時間

AFE 延遲時間指標會測量 Spanner AFE 從用戶端接收 RPC 要求，到 Spanner 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) 要求從用戶端傳送至 Spanner 所需的時間。attempt_latencies 值通常與 operation_latencies 值相同。不過，如果用戶端收到暫時性錯誤，operation_latencies 值則是所有 attempt_latencies 值的總和。

「嘗試延遲」指標具有下列屬性：

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

GFE 連線錯誤計數

GFE 連線錯誤計數指標會記錄無法送達 GFE 的 RPC 要求數量。

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

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

GFE 延遲時間

GFE 延遲時間指標會測量 GFE 從用戶端接收 RPC 要求，到 GFE 接收回應的第一個位元組之間的時間。這項指標不會計入任何 TCP/SSL 交握所用的時間。

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

後續步驟