This documentation has an index for AI agents at /llms.txt. A Markdown version of this page is available at https://explorer.opentelemetry.io/java-agent/instrumentation/jedis-3.0.md.

Jedis

OpenTelemetry Java agent instrumentation

This instrumentation enables database client spans and database client metrics for Jedis Redis operations.

  • Name: jedis-3.0
  • Scope: io.opentelemetry.jedis-3.0
  • Target versions: redis.clients:jedis:[3.0.0,4)
  • Library: https://github.com/redis/jedis

Telemetry

When default

Spans

Span kindAttributes
CLIENTdb.operation (STRING), db.statement (STRING), db.system (STRING), network.peer.address (STRING), network.peer.port (LONG), network.type (STRING), peer.service (STRING), server.address (STRING), server.port (LONG)

When otel.semconv-stability.opt-in=database,service.peer

Metrics

MetricInstrumentTypeUnitDescription
db.client.operation.durationhistogramHISTOGRAMsDuration of database client operations.
MetricAttributes
db.client.operation.durationdb.namespace (STRING), db.operation.name (STRING), db.system.name (STRING), network.peer.address (STRING), network.peer.port (LONG), server.address (STRING), server.port (LONG)

Spans

Span kindAttributes
CLIENTdb.namespace (STRING), db.operation.batch.size (LONG), db.operation.name (STRING), db.query.text (STRING), db.system.name (STRING), network.peer.address (STRING), network.peer.port (LONG), server.address (STRING), server.port (LONG), service.peer.name (STRING)

Configuration

OptionTypeDefaultDescription
java.common.database.statement_sanitizer.enabledbooleantrueDeprecated: use java.common.db.query_sanitization.enabled instead. It is ignored under v3 preview.
otel.instrumentation.common.db-statement-sanitizer.enabledbooleantrueDeprecated: use otel.instrumentation.common.db.query-sanitization.enabled instead. It is ignored under v3 preview and will be removed in 3.0.
otel.instrumentation.common.db.query-sanitization.enabledbooleantrueEnables query sanitization for database queries.
otel.instrumentation.common.peer-service-mappingmapUsed to specify a mapping from server addresses or configured targets to peer services. Configured targets containing commas or equals signs can only be mapped with declarative service_peer_mapping.
otel.instrumentation.jedis.query-sanitization.enabledbooleanEnables query sanitization for Jedis queries. Overrides otel.instrumentation.common.db.query-sanitization.enabled for this instrumentation; when unset, that setting applies.
otel.instrumentation.jedis.statement-sanitizer.enabledbooleanDeprecated: use otel.instrumentation.jedis.query-sanitization.enabled instead. It is ignored under v3 preview and will be removed in 3.0. When unset, this setting falls back to otel.instrumentation.common.db.query-sanitization.enabled (including its deprecated aliases).

Data

  • JSON (latest): /data/javaagent/instrumentations/jedis-3.0/latest.json
  • JSON (pinned): /data/javaagent/instrumentations/jedis-3.0/jedis-3.0-5051c17fc268.json
  • Explore: /java-agent/instrumentation/jedis-3.0