This version is still in development and is not considered stable yet. For the latest stable version, please use Spring Data Redis 3.3.5!

Observability

Getting insights from an application component about its operations, timing and relation to application code is crucial to understand latency. Spring Data Redis ships with a Micrometer integration through the Lettuce driver to collect observations during Redis interaction. Once the integration is set up, Micrometer will create meters and spans (for distributed tracing) for each Redis command.

To enable the integration, apply the following configuration to LettuceClientConfiguration:

@Configuration
class ObservabilityConfiguration {

  @Bean
  public ClientResources clientResources(ObservationRegistry observationRegistry) {

    return ClientResources.builder()
              .tracing(new MicrometerTracingAdapter(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);
  }
}

See also OpenTelemetry Semantic Conventions for further reference.

Observability - Metrics

Below you can find a list of all metrics declared by this project.

Redis Command Observation

Timer created around a Redis command execution.

Metric name spring.data.redis. Type timer and base unit seconds.

Fully qualified name of the enclosing class org.springframework.data.redis.connection.lettuce.observability.RedisObservation.

Table 1. Low cardinality Keys

Name

Description

db.operation

Redis command value.

db.redis.database_index

Redis database index.

db.system

Database system.

db.user

Redis user.

net.peer.name

Name of the database host.

net.peer.port

Logical remote port number.

net.sock.peer.addr

Mongo peer address.

net.sock.peer.port

Mongo peer port.

net.transport

Network transport.

Table 2. High cardinality Keys

Name

Description

db.statement

Redis statement.

spring.data.redis.command.error

Redis error response.

Observability - Spans

Below you can find a list of all spans declared by this project.

Redis Command Observation Span

Timer created around a Redis command execution.

Span name spring.data.redis.

Fully qualified name of the enclosing class org.springframework.data.redis.connection.lettuce.observability.RedisObservation.

Table 3. Tag Keys

Name

Description

db.operation

Redis command value.

db.redis.database_index

Redis database index.

db.statement

Redis statement.

db.system

Database system.

db.user

Redis user.

net.peer.name

Name of the database host.

net.peer.port

Logical remote port number.

net.sock.peer.addr

Mongo peer address.

net.sock.peer.port

Mongo peer port.

net.transport

Network transport.

spring.data.redis.command.error

Redis error response.