# NATS Client

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables messaging spans for NATS message producers and consumers.

- **Name**: `nats-2.17`
- **Scope**: `io.opentelemetry.nats-2.17`
- **Target versions**: `io.nats:jnats:[2.17.2,)`
- **Library**: https://nats.io/

## Telemetry

- **Span attributes**: `messaging.client_id`, `messaging.destination.name`, `messaging.destination.temporary`, `messaging.message.body.size`, `messaging.operation`, `messaging.system`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.messaging.experimental.capture-headers` | list |  | A comma-separated list of header names to capture as span attributes. |

## Data

- **JSON**: [/data/javaagent/instrumentations/nats-2.17/nats-2.17-286f295014e4.json](/data/javaagent/instrumentations/nats-2.17/nats-2.17-286f295014e4.json)
- **Explore**: [/java-agent/instrumentation/nats-2.17](/java-agent/instrumentation/nats-2.17)
