|
对于最新的稳定版本，请使用 Spring Data Redis 4.0.4！ |
可观测性
从应用程序组件获取有关其操作、耗时以及与应用程序代码关系的深入信息，对于理解延迟至关重要。 Spring Data Redis 通过 Lettuce 驱动程序集成了 Micrometer，以便在与 Redis 交互期间收集观测数据。 一旦集成设置完成，Micrometer 将为每个 Redis 命令创建度量指标（meters）和跨度（spans，用于分布式追踪）。
要启用该集成，请将以下配置应用于LettuceClientConfiguration：
@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。
根据你是否只需要指标（Metrics）还是同时需要指标和追踪（Tracing），你可能希望在应用程序中排除该自动配置类。 |
使用 Lettuce 内置的 MicrometerTracing，因为 MicrometerTracingAdapter 已被弃用，并将在未来的版本中移除。 |
另请参阅OpenTelemetry 语义约定以获取更多参考信息。
可观测性 - 指标
以下列出了 MicrometerTracingAdapter 记录的所有指标。
Redis 命令观测
围绕 Redis 命令执行创建的计时器。
指标名称 spring.data.redis。类型 timer，基本单位 seconds。
封闭类 org.springframework.data.redis.connection.lettuce.observability.RedisObservation 的全限定名。
姓名 |
描述 |
|
Redis 命令值。 |
|
Redis 数据库索引。 |
|
数据库系统。 |
|
Redis 用户。 |
|
数据库主机的名称。 |
|
逻辑远程端口号。 |
|
Mongo 对等地址。 |
|
Mongo 对等端口。 |
|
网络传输。 |
姓名 |
描述 |
|
Redis 语句。 |
|
Redis 错误响应。 |
Redis 命令观测跨度
围绕 Redis 命令执行创建的计时器。
Span 名称 spring.data.redis。
封闭类 org.springframework.data.redis.connection.lettuce.observability.RedisObservation 的全限定名。
姓名 |
描述 |
|
Redis 命令值。 |
|
Redis 数据库索引。 |
|
Redis 语句。 |
|
数据库系统。 |
|
Redis 用户。 |
|
数据库主机的名称。 |
|
逻辑远程端口号。 |
|
Mongo 对等地址。 |
|
Mongo 对等端口。 |
|
网络传输。 |
|
Redis 错误响应。 |