客户端指标说明

本页详细介绍了 Spanner 提供的每项客户端指标。如需详细了解如何查看和管理客户端指标,请参阅查看和管理客户端指标

客户端指标可提供有关客户端向 Spanner 发出的 RPC 请求尝试操作的延迟时间信息。

一次尝试是指客户端向 Spanner 发出的单个 RPC 请求。如果请求失败,客户端可以多次尝试。

操作表示所有 RPC 请求的完成,包括客户端向 Spanner 发出的所有尝试。当客户端收到响应或所有尝试都已用尽时,操作即完成。

RPC 请求首先到达 Google 前端 (GFE),然后到达 Spanner API 前端 (AFE)。如需了解详情,请参阅 Spanner 请求中的延迟时间点

这些指标包括 DISTRIBUTIONINT64 指标值类型。如需了解详情,请参阅值类型和指标种类

您可以使用 Java 版或 Go 版 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 状态,例如 OKINTERNAL
  • client_name:库名称和版本,例如 spanner-java/6.70.1

AFE 连接错误计数

AFE 连接错误数指标用于记录未能连接到 Spanner AFE 的 RPC 请求数。

AFE 连接错误数指标具有以下属性:

  • Metric namespanner.googleapis.com/client/afe_connectivity_error_count
  • Metric value typeINT64

AFE 延迟时间

AFE 延迟时间指标用于衡量从 Spanner AFE 接收到来自客户端的 RPC 请求到 Spanner AFE 开始写入响应之间的时间。

AFE 延迟时间指标具有以下属性:

  • Metric namespanner.googleapis.com/client/afe_latencies
  • Metric value typeDISTRIBUTION

尝试次数

尝试次数指标会记录执行的尝试次数。attempt_count 值通常与 operation_count 值相同。如果客户端收到暂时性错误,则 attempt_count 值是所有尝试的总和。

“尝试次数”指标具有以下属性:

  • Metric namespanner.googleapis.com/client/attempt_count
  • Metric value typeINT64

尝试延迟时间

尝试延迟时间指标用于衡量单个 RPC 请求从客户端到达 Spanner 所需的时间。attempt_latencies 值通常与 operation_latencies 值相同。如果客户端收到暂时性错误,则 operation_latencies 值是所有 attempt_latencies 值的总和。

“尝试延迟时间”指标具有以下属性:

  • Metric namespanner.googleapis.com/client/attempt_latencies
  • Metric value typeDISTRIBUTION

GFE 连接错误计数

“GFE 连接错误计数”指标记录了未能连接到 GFE 的 RPC 请求数。

GFE 连接错误数指标具有以下属性:

  • Metric namespanner.googleapis.com/client/gfe_connectivity_error_count
  • Metric value typeINT64

GFE 延迟时间

GFE 延迟时间指标衡量的是 GFE 从客户端收到 RPC 请求到收到响应的第一个字节之间的时间。此指标不考虑任何 TCP/SSL 握手所用的时间。

“GFE 延迟时间”指标具有以下属性:

  • Metric namespanner.googleapis.com/client/gfe_latencies
  • Metric value typeDISTRIBUTION

操作次数

操作次数指标会记录每 60 秒执行的操作次数。

“操作次数”指标具有以下属性:

  • Metric namespanner.googleapis.com/client/operation_count
  • Metric value typeINT64

操作延迟时间

操作延迟时间指标衡量操作从客户端 gRPC 层到 Spanner 再返回客户端的往返时间。

“操作延迟时间”指标具有以下属性:

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

后续步骤