# Couchbase Client

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

> OpenTelemetry Java agent instrumentation

Couchbase instrumentation is owned by the Couchbase project for versions 3+. This instrumentation automatically configures the instrumentation provided by the Couchbase library.

- **Name**: `couchbase-3.1`
- **Scope**: `io.opentelemetry.couchbase-3.1`
- **Target versions**: `com.couchbase.client:java-client:[3.1,3.1.6)`
- **Library**: https://github.com/couchbase/couchbase-java-client

## Telemetry

- **Span attributes**: `db.couchbase.collection`, `db.couchbase.local_id`, `db.couchbase.operation_id`, `db.couchbase.scope`, `db.couchbase.server_duration`, `db.couchbase.service`, `db.name`, `db.operation`, `db.system`, `net.host.name`, `net.host.port`, `net.peer.name`, `net.peer.port`, `net.transport`, `db.collection.name`, `db.namespace`, `db.operation.name`, `db.system.name`, `network.peer.address`, `network.peer.port`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.couchbase.experimental-span-attributes` | boolean | false | Enables experimental span attributes emitted from the underlying Couchbase library. |

## Data

- **JSON**: [/data/javaagent/instrumentations/couchbase-3.1/couchbase-3.1-9a5e5faf644a.json](/data/javaagent/instrumentations/couchbase-3.1/couchbase-3.1-9a5e5faf644a.json)
- **Explore**: [/java-agent/instrumentation/couchbase-3.1](/java-agent/instrumentation/couchbase-3.1)