# Elasticsearch Transport Client

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables database client spans and database client metrics for Elasticsearch transport client requests. Each call produces a span named after the Elasticsearch action, enriched with transport-specific attributes.

- **Name**: `elasticsearch-transport-5.0`
- **Scope**: `io.opentelemetry.elasticsearch-transport-5.0`
- **Target versions**: `org.elasticsearch.client:transport:[5.0.0,5.3.0)`, `org.elasticsearch:elasticsearch:[5.0.0,5.3.0)`
- **Library**: https://www.elastic.co/guide/en/elasticsearch/client/java-api/

## Telemetry

- **Metrics**: `db.client.operation.duration`
- **Span attributes**: `db.operation`, `db.system`, `network.peer.address`, `network.peer.port`, `elasticsearch.action`, `elasticsearch.id`, `elasticsearch.request`, `elasticsearch.request.indices`, `elasticsearch.request.write.type`, `elasticsearch.response.status`, `elasticsearch.shard.replication.failed`, `elasticsearch.shard.replication.successful`, `elasticsearch.shard.replication.total`, `elasticsearch.type`, `elasticsearch.version`, `db.operation.name`, `db.system.name`, `error.type`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.elasticsearch.experimental-span-attributes` | boolean | false | Enable the capture of the experimental span attributes `elasticsearch.action`, `elasticsearch.id`, `elasticsearch.request`, `elasticsearch.request.indices`, `elasticsearch.request.write.routing`, `elasticsearch.request.write.type`, `elasticsearch.response.status`, `elasticsearch.shard.replication.failed`, `elasticsearch.shard.replication.successful`, `elasticsearch.shard.replication.total`, `elasticsearch.type`, and `elasticsearch.version`. |

## Data

- **JSON**: [/data/javaagent/instrumentations/elasticsearch-transport-5.0/elasticsearch-transport-5.0-8a0781228bb1.json](/data/javaagent/instrumentations/elasticsearch-transport-5.0/elasticsearch-transport-5.0-8a0781228bb1.json)
- **Explore**: [/java-agent/instrumentation/elasticsearch-transport-5.0](/java-agent/instrumentation/elasticsearch-transport-5.0)