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/kafka-clients-0.11.md.

Apache Kafka Client

OpenTelemetry Java agent instrumentation

This instrumentation enables messaging spans for Kafka producers and consumers, and collects internal Kafka client metrics.

  • Name: kafka-clients-0.11
  • Scope: io.opentelemetry.kafka-clients-0.11
  • Target versions: org.apache.kafka:kafka-clients:[0.11.0.0,)
  • Library: https://kafka.apache.org/

Telemetry

  • Span attributes: messaging.batch.message_count, messaging.client_id, messaging.destination.name, messaging.destination.partition.id, messaging.kafka.consumer.group, messaging.kafka.message.key, messaging.kafka.message.offset, messaging.kafka.message.tombstone, messaging.message.body.size, messaging.operation, messaging.system, kafka.record.queue_time_ms, messaging.kafka.bootstrap.servers, messaging.kafka.offset

Configuration

OptionTypeDefaultDescription
otel.instrumentation.messaging.experimental.capture-headerslistA comma-separated list of header names to capture as span attributes.
otel.instrumentation.kafka.experimental-span-attributesbooleanfalseEnables the capture of the experimental consumer attributes kafka.record.queue_time_ms and messaging.kafka.bootstrap.servers.
otel.instrumentation.kafka.producer-propagation.enabledbooleantrueEnable context propagation for Kafka message producers.
otel.instrumentation.messaging.experimental.receive-telemetry.enabledbooleanfalseEnables experimental receive telemetry, which will cause consumers to start a new trace, with only a span link connecting it to the producer trace.

Data

  • JSON: /data/javaagent/instrumentations/kafka-clients-0.11/kafka-clients-0.11-0463da0d0c5d.json
  • Explore: /java-agent/instrumentation/kafka-clients-0.11