# Apache RocketMQ Client - gRPC Protocol

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables messaging spans for Apache RocketMQ message producers and consumers using the gRPC/Protobuf Protocol.

- **Name**: `rocketmq-client-5.0`
- **Scope**: `io.opentelemetry.rocketmq-client-5.0`
- **Target versions**: `org.apache.rocketmq:rocketmq-client-java:[5.0.0,)`
- **Library**: https://rocketmq.apache.org/

## Telemetry

- **Span attributes**: `messaging.batch.message_count`, `messaging.destination.name`, `messaging.message.body.size`, `messaging.message.id`, `messaging.operation`, `messaging.rocketmq.client_group`, `messaging.rocketmq.message.delivery_timestamp`, `messaging.rocketmq.message.group`, `messaging.rocketmq.message.keys`, `messaging.rocketmq.message.tag`, `messaging.system`, `messaging.rocketmq.message.type`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.messaging.experimental.capture-headers` | list |  | A comma-separated list of header names to capture as span attributes. |
| `otel.instrumentation.messaging.experimental.receive-telemetry.enabled` | boolean | false | Enables 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/rocketmq-client-5.0/rocketmq-client-5.0-b1f82c75914b.json](/data/javaagent/instrumentations/rocketmq-client-5.0/rocketmq-client-5.0-b1f82c75914b.json)
- **Explore**: [/java-agent/instrumentation/rocketmq-client-5.0](/java-agent/instrumentation/rocketmq-client-5.0)