此版本仍在开发中，尚未被视为稳定版本。对于最新的稳定版本，请使用 Spring Data Cassandra 4.4.0！spring-doc.cadn.net.cn

可观察性

从应用程序组件中获取有关其作、计时以及与应用程序代码的关系的见解对于了解延迟至关重要。 Spring Data Cassandra 通过 Cassandra 驱动程序附带了一个 Micrometer 检测，用于在 Cassandra 交互期间收集观察结果。设置集成后，Micrometer 将为每个 Cassandra 语句创建 meter 和 span（用于分布式跟踪）。spring-doc.cadn.net.cn

要启用检测，请将以下配置应用于您的应用程序：spring-doc.cadn.net.cn

@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.INSTANCE`使用`CqlSessionBuilder`.
2	包装 CQL 会话对象以观察反应式 Cassandra 语句的执行情况。

双ObservableCqlSessionFactoryBean和ObservableReactiveSessionFactoryBean支持配置CassandraObservationConvention.spring-doc.cadn.net.cn

另请参阅 OpenTelemetry 语义约定以获取进一步参考。spring-doc.cadn.net.cn

约定

您可以在下面找到所有GlobalObservabilityConventions和ObservabilityConventions由此项目声明。spring-doc.cadn.net.cn

表 1.ObservationConvention 实现
ObservationConvention 类名spring-doc.cadn.net.cn	适用的 ObservationContext 类名spring-doc.cadn.net.cn
`org.springframework.data.cassandra.observability.DefaultCassandraObservationConvention`spring-doc.cadn.net.cn	`n/a`spring-doc.cadn.net.cn

指标

您可以在下面找到此项目声明的所有指标的列表。spring-doc.cadn.net.cn

Cassandra 查询观察

创建一个io.micrometer.observation.Observation对于基于 Cassandra 的查询。spring-doc.cadn.net.cn

指标名称 spring.data.cassandra.query.类型 timer和基本单位 seconds.spring-doc.cadn.net.cn

封闭类的完全限定名称org.springframework.data.cassandra.observability.CassandraObservation.spring-doc.cadn.net.cn

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

表 3.高基数键
名字spring-doc.cadn.net.cn	描述spring-doc.cadn.net.cn
`db.cassandra.consistency_level`spring-doc.cadn.net.cn
`db.cassandra.idempotence`spring-doc.cadn.net.cn
`db.cassandra.page_size`spring-doc.cadn.net.cn
`db.statement`spring-doc.cadn.net.cn	包含 Cassandra CQL 的键值。spring-doc.cadn.net.cn
`spring.data.cassandra.node[%s].error`spring-doc.cadn.net.cn	包含给定节点发生的错误的标签。（因为名称包含`%s`最终值将在运行时解析）spring-doc.cadn.net.cn

跨越

您可以在下面找到此项目声明的所有 span 的列表。spring-doc.cadn.net.cn

Cassandra 查询观察跨度

创建一个io.micrometer.observation.Observation对于基于 Cassandra 的查询。spring-doc.cadn.net.cn

Span 名称 spring.data.cassandra.query.spring-doc.cadn.net.cn

封闭类的完全限定名称org.springframework.data.cassandra.observability.CassandraObservation.spring-doc.cadn.net.cn

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