可观测性 (Observability) _ Spring Data for Apache Cassandra 4.3.1 中文文档(官方文档中文翻译) —

从应用程序组件中获取有关其操作、时序以及与应用程序代码的关系的见解对于了解延迟至关重要。 Spring Data Cassandra 通过 Cassandra 驱动程序附带了 Micrometer 仪器，用于在 Cassandra 交互期间收集观察结果。设置集成后，Micrometer 将为每个 Cassandra 语句创建米和跨度（用于分布式跟踪）。Spring中文文档

若要启用检测，请将以下配置应用于应用程序：Spring中文文档

@Configuration
class ObservabilityConfiguration {

  @Bean
  public ObservableCqlSessionFactoryBean observableCqlSession(CqlSessionBuilder builder,
                                                              ObservationRegistry registry) {
    return new ObservableCqlSessionFactoryBean(builder, registry); (1)
  }

  @Bean
  public ObservableReactiveSessionFactoryBean observableReactiveSession(CqlSession session,
                                                              ObservationRegistry registry) {
    return new ObservableReactiveSessionFactoryBean(session, registry); (2)
  }
}

1	包装 CQL 会话对象以观察 Cassandra 语句的执行。此外，使用 .`ObservationRequestTracker.INSTANCECqlSessionBuilder`
2	包装 CQL 会话对象以观察反应式 Cassandra 语句执行。

另请参阅 OpenTelemetry 语义约定以获取进一步参考。Spring中文文档

1	包装 CQL 会话对象以观察 Cassandra 语句的执行。此外，使用 .`ObservationRequestTracker.INSTANCECqlSessionBuilder`
2	包装 CQL 会话对象以观察反应式 Cassandra 语句执行。

约定

您可以在下面找到该项目声明的所有列表。GlobalObservabilityConventionsObservabilityConventionsSpring中文文档

表 1.观察公约实现
ObservationConvention 类名称Spring中文文档	适用的 ObservationContext 类名Spring中文文档
`org.springframework.data.cassandra.observability.DefaultCassandraObservationConvention`Spring中文文档	`n/a`Spring中文文档

表 1.观察公约实现
ObservationConvention 类名称Spring中文文档	适用的 ObservationContext 类名Spring中文文档
`org.springframework.data.cassandra.observability.DefaultCassandraObservationConvention`Spring中文文档	`n/a`Spring中文文档

指标

您可以在下面找到此项目声明的所有指标的列表。Spring中文文档

Cassandra 查询观察

创建一个基于 Cassandra 的查询。io.micrometer.observation.ObservationSpring中文文档

指标名称 。类型和基本单位。spring.data.cassandra.querytimersecondsSpring中文文档

封闭类 .org.springframework.data.cassandra.observability.CassandraObservationSpring中文文档

表 2.低基数键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.coordinator.dc`Spring中文文档
`db.cassandra.coordinator.id`Spring中文文档
`db.name`Spring中文文档	Cassandra 密钥空间的名称。Spring中文文档
`db.operation`Spring中文文档	数据库操作。Spring中文文档
`db.system`Spring中文文档	数据库系统。Spring中文文档
`net.peer.name`Spring中文文档	数据库主机的名称。Spring中文文档
`net.peer.port`Spring中文文档	逻辑远程端口号。Spring中文文档
`net.sock.peer.addr`Spring中文文档	Cassandra 对等地址。Spring中文文档
`net.sock.peer.port`Spring中文文档	Cassandra 对等端口。Spring中文文档
`net.transport`Spring中文文档	网络传输。Spring中文文档
`spring.data.cassandra.methodName`Spring中文文档	方法名称Spring中文文档
`spring.data.cassandra.sessionName`Spring中文文档	Cassandra 会话Spring中文文档

表 3.高基数键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.consistency_level`Spring中文文档
`db.cassandra.idempotence`Spring中文文档
`db.cassandra.page_size`Spring中文文档
`db.statement`Spring中文文档	包含 Cassandra CQL 的键值。Spring中文文档
`spring.data.cassandra.node[%s].error`Spring中文文档	包含给定节点发生的错误的标记。（由于名称包含最终值将在运行时解析）`%s`Spring中文文档

表 2.低基数键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.coordinator.dc`Spring中文文档
`db.cassandra.coordinator.id`Spring中文文档
`db.name`Spring中文文档	Cassandra 密钥空间的名称。Spring中文文档
`db.operation`Spring中文文档	数据库操作。Spring中文文档
`db.system`Spring中文文档	数据库系统。Spring中文文档
`net.peer.name`Spring中文文档	数据库主机的名称。Spring中文文档
`net.peer.port`Spring中文文档	逻辑远程端口号。Spring中文文档
`net.sock.peer.addr`Spring中文文档	Cassandra 对等地址。Spring中文文档
`net.sock.peer.port`Spring中文文档	Cassandra 对等端口。Spring中文文档
`net.transport`Spring中文文档	网络传输。Spring中文文档
`spring.data.cassandra.methodName`Spring中文文档	方法名称Spring中文文档
`spring.data.cassandra.sessionName`Spring中文文档	Cassandra 会话Spring中文文档

表 3.高基数键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.consistency_level`Spring中文文档
`db.cassandra.idempotence`Spring中文文档
`db.cassandra.page_size`Spring中文文档
`db.statement`Spring中文文档	包含 Cassandra CQL 的键值。Spring中文文档
`spring.data.cassandra.node[%s].error`Spring中文文档	包含给定节点发生的错误的标记。（由于名称包含最终值将在运行时解析）`%s`Spring中文文档

跨越

您可以在下面找到此项目声明的所有跨度的列表。Spring中文文档

Cassandra 查询观察范围

创建一个基于 Cassandra 的查询。io.micrometer.observation.ObservationSpring中文文档

跨度名称 。spring.data.cassandra.querySpring中文文档

封闭类 .org.springframework.data.cassandra.observability.CassandraObservationSpring中文文档

表 4.标签键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.consistency_level`Spring中文文档
`db.cassandra.coordinator.dc`Spring中文文档
`db.cassandra.coordinator.id`Spring中文文档
`db.cassandra.idempotence`Spring中文文档
`db.cassandra.page_size`Spring中文文档
`db.name`Spring中文文档	Cassandra 密钥空间的名称。Spring中文文档
`db.operation`Spring中文文档	数据库操作。Spring中文文档
`db.statement`Spring中文文档	包含 Cassandra CQL 的键值。Spring中文文档
`db.system`Spring中文文档	数据库系统。Spring中文文档
`net.peer.name`Spring中文文档	数据库主机的名称。Spring中文文档
`net.peer.port`Spring中文文档	逻辑远程端口号。Spring中文文档
`net.sock.peer.addr`Spring中文文档	Cassandra 对等地址。Spring中文文档
`net.sock.peer.port`Spring中文文档	Cassandra 对等端口。Spring中文文档
`net.transport`Spring中文文档	网络传输。Spring中文文档
`spring.data.cassandra.methodName`Spring中文文档	方法名称Spring中文文档
`spring.data.cassandra.node[%s].error`Spring中文文档	包含给定节点发生的错误的标记。（由于名称包含最终值将在运行时解析）`%s`Spring中文文档
`spring.data.cassandra.sessionName`Spring中文文档	Cassandra 会话Spring中文文档

表 4.标签键
名字Spring中文文档	描述Spring中文文档
`db.cassandra.consistency_level`Spring中文文档
`db.cassandra.coordinator.dc`Spring中文文档
`db.cassandra.coordinator.id`Spring中文文档
`db.cassandra.idempotence`Spring中文文档
`db.cassandra.page_size`Spring中文文档
`db.name`Spring中文文档	Cassandra 密钥空间的名称。Spring中文文档
`db.operation`Spring中文文档	数据库操作。Spring中文文档
`db.statement`Spring中文文档	包含 Cassandra CQL 的键值。Spring中文文档
`db.system`Spring中文文档	数据库系统。Spring中文文档
`net.peer.name`Spring中文文档	数据库主机的名称。Spring中文文档
`net.peer.port`Spring中文文档	逻辑远程端口号。Spring中文文档
`net.sock.peer.addr`Spring中文文档	Cassandra 对等地址。Spring中文文档
`net.sock.peer.port`Spring中文文档	Cassandra 对等端口。Spring中文文档
`net.transport`Spring中文文档	网络传输。Spring中文文档
`spring.data.cassandra.methodName`Spring中文文档	方法名称Spring中文文档
`spring.data.cassandra.node[%s].error`Spring中文文档	包含给定节点发生的错误的标记。（由于名称包含最终值将在运行时解析）`%s`Spring中文文档
`spring.data.cassandra.sessionName`Spring中文文档	Cassandra 会话Spring中文文档