# Lettuce

<!-- llms-txt-link: /llms.txt -->

> OpenTelemetry Java agent instrumentation

This instrumentation enables database client spans and database client metrics for the Lettuce Redis client.

- **Name**: `lettuce-5.0`
- **Scope**: `io.opentelemetry.lettuce-5.0`
- **Target versions**: `io.lettuce:lettuce-core:[5.0.0.RELEASE,5.1.0.RELEASE)`
- **Library**: https://github.com/redis/lettuce

## Telemetry

- **Metrics**: `db.client.operation.duration`
- **Span attributes**: `db.operation`, `db.statement`, `db.system`, `server.address`, `server.port`, `db.operation.batch.size`, `db.operation.name`, `db.query.text`, `db.system.name`, `error.type`, `peer.service`, `service.peer.name`, `lettuce.command.cancelled`, `lettuce.command.results.count`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.common.db.query-sanitization.enabled` | boolean | true | Enables query sanitization for database queries. |
| `otel.instrumentation.common.peer-service-mapping` | map |  | Used to specify a mapping from host names or IP addresses to peer services. |
| `otel.instrumentation.lettuce.connection-telemetry.enabled` | boolean | false | Enables connection telemetry spans for Redis connections. |
| `otel.instrumentation.lettuce.experimental-span-attributes` | boolean | false | Enables experimental span attributes `lettuce.command.cancelled` and `lettuce.command.results.count`. |

## Data

- **JSON**: [/data/javaagent/instrumentations/lettuce-5.0/lettuce-5.0-d7ec5eae2e28.json](/data/javaagent/instrumentations/lettuce-5.0/lettuce-5.0-d7ec5eae2e28.json)
- **Explore**: [/java-agent/instrumentation/lettuce-5.0](/java-agent/instrumentation/lettuce-5.0)