用戶端指標說明

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

用戶端指標會提供用戶端遠端程序呼叫 (RPC) 要求嘗試和對 Spanner 執行的作業的延遲時間資訊。

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

作業代表所有 RPC 要求 (包括用戶端對 Spanner 所做的所有嘗試) 完成的情況。當用戶端收到回應或嘗試次數用盡時，作業就會完成。

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

使用 Java 或 Go 專用的 Spanner 用戶端程式庫時，您可以使用用戶端指標。

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

作業延遲時間

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

這項指標的屬性如下：

  • Metric name ：spanner.googleapis.com/client/operation_latencies
  • Metric value type：DISTRIBUTION
  • 可用維度：
    • 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。

作業數

作業數指標會記錄執行的作業數量。

這項指標的屬性如下：

  • Metric name：spanner.googleapis.com/client/operation_count
  • Metric value type：INT64
  • 可用維度：
    • 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。

嘗試延遲時間

嘗試延遲時間指標會評估單一 RPC 要求從用戶端傳送至 Spanner 所需的時間。attempt_latencies 值通常與 operation_latencies 值相同。如果用戶端收到暫時性錯誤，operation_latencies 值就是所有 attempt_latencies 值的總和。

這項指標的屬性如下：

  • Metric name：spanner.googleapis.com/client/attempt_latencies
  • Metric value type：DISTRIBUTION
  • 可用維度：
    • 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。

嘗試次數

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

這項指標的屬性如下：

  • Metric name：spanner.googleapis.com/client/attempt_count
  • Metric value type：INT64
  • 可用維度：
    • 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。

後續步驟