本页详细介绍了 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
: 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
。
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 请求到收到响应的第一个字节之间的时间。此指标不考虑任何 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