客户端指标说明

本页详细介绍了 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。

后续步骤