可观察性

从应用程序组件中获取有关其作、计时以及与应用程序代码的关系的见解对于了解延迟至关重要。 Spring Data Redis 通过 Lettuce 驱动程序附带了 Micrometer 集成,用于在 Redis 交互期间收集观察结果。 设置集成后,Micrometer 将为每个 Redis 命令创建仪表和跨度(用于分布式跟踪)。spring-doc.cadn.net.cn

要启用集成,请将以下配置应用于LettuceClientConfiguration:spring-doc.cadn.net.cn

@Configuration
class ObservabilityConfiguration {

  @Bean
  public ClientResources clientResources(ObservationRegistry observationRegistry) {

    return ClientResources.builder()
              .tracing(new MicrometerTracing(observationRegistry, "my-redis-cache"))
              .build();
  }

  @Bean
  public LettuceConnectionFactory lettuceConnectionFactory(ClientResources clientResources) {

    LettuceClientConfiguration clientConfig = LettuceClientConfiguration.builder()
                                                .clientResources(clientResources).build();
    RedisConfiguration redisConfiguration = …;
    return new LettuceConnectionFactory(redisConfiguration, clientConfig);
  }
}
使用 Spring Boot 时,LettuceMetricsAutoConfiguration配置 Lettuce 的MicrometerCommandLatencyRecorder. 根据您是只想要指标还是指标和跟踪,您可能希望在应用程序中排除此自动配置类。
使用生菜内置的MicrometerTracingMicrometerTracingAdapter已弃用,以便在将来的版本中删除。

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

可观测性 - 指标

您可以在下面找到记录的所有指标的列表MicrometerTracingAdapter.spring-doc.cadn.net.cn

Redis 命令观察

围绕 Redis 命令执行创建的计时器。spring-doc.cadn.net.cn

指标名称 spring.data.redis.类型 timer基本单元 seconds.spring-doc.cadn.net.cn

封闭类的完全限定名称org.springframework.data.redis.connection.lettuce.observability.RedisObservation.spring-doc.cadn.net.cn

表 1.低基数键

Redis 命令值。spring-doc.cadn.net.cn

db.redis.database_indexspring-doc.cadn.net.cn

Redis 数据库索引。spring-doc.cadn.net.cn

数据库系统。spring-doc.cadn.net.cn

Redis 用户。spring-doc.cadn.net.cn

net.peer.namespring-doc.cadn.net.cn

数据库主机的名称。spring-doc.cadn.net.cn

net.peer.portspring-doc.cadn.net.cn

逻辑远程端口号。spring-doc.cadn.net.cn

net.sock.peer.addrspring-doc.cadn.net.cn

Mongo 对等地址。spring-doc.cadn.net.cn

net.sock.peer.portspring-doc.cadn.net.cn

Mongo 对等端口。spring-doc.cadn.net.cn

net.transportspring-doc.cadn.net.cn

网络传输。spring-doc.cadn.net.cn

表 2.高基数键

Redis 语句。spring-doc.cadn.net.cn

spring.data.redis.command.errorspring-doc.cadn.net.cn

Redis 错误响应。spring-doc.cadn.net.cn

可观测性 - 跨度

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

Redis 命令观察范围

围绕 Redis 命令执行创建的计时器。spring-doc.cadn.net.cn

跨度名称 spring.data.redis.spring-doc.cadn.net.cn

封闭类的完全限定名称org.springframework.data.redis.connection.lettuce.observability.RedisObservation.spring-doc.cadn.net.cn

表 3.标记键

名称spring-doc.cadn.net.cn

描述spring-doc.cadn.net.cn

db.operationspring-doc.cadn.net.cn

Redis 命令值。spring-doc.cadn.net.cn

db.redis.database_indexspring-doc.cadn.net.cn

Redis 数据库索引。spring-doc.cadn.net.cn

db.statementspring-doc.cadn.net.cn

Redis 语句。spring-doc.cadn.net.cn

db.systemspring-doc.cadn.net.cn

数据库系统。spring-doc.cadn.net.cn

db.userspring-doc.cadn.net.cn

Redis 用户。spring-doc.cadn.net.cn

net.peer.namespring-doc.cadn.net.cn

数据库主机的名称。spring-doc.cadn.net.cn

net.peer.portspring-doc.cadn.net.cn

逻辑远程端口号。spring-doc.cadn.net.cn

net.sock.peer.addrspring-doc.cadn.net.cn

Mongo 对等地址。spring-doc.cadn.net.cn

net.sock.peer.portspring-doc.cadn.net.cn

Mongo 对等端口。spring-doc.cadn.net.cn

net.transportspring-doc.cadn.net.cn

网络传输。spring-doc.cadn.net.cn

spring.data.redis.command.errorspring-doc.cadn.net.cn

Redis 错误响应。spring-doc.cadn.net.cn