# ClickHouse Java Client

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables database client spans and database client metrics for the ClickHouse Java Client.

- **Name**: `clickhouse-client-v1-0.5`
- **Scope**: `io.opentelemetry.clickhouse-client-v1-0.5`
- **Target versions**: `com.clickhouse:clickhouse-client:[0.5.0,)`
- **Library**: https://github.com/ClickHouse/clickhouse-java

## Telemetry

- **Metrics**: `db.client.operation.duration`
- **Span attributes**: `db.name`, `db.operation`, `db.statement`, `db.system`, `server.address`, `server.port`, `db.namespace`, `db.query.summary`, `db.query.text`, `db.system.name`, `error.type`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.instrumentation.common.db.query-sanitization.enabled` | boolean | true | Enables query sanitization for database queries. |

## Data

- **JSON**: [/data/javaagent/instrumentations/clickhouse-client-v1-0.5/clickhouse-client-v1-0.5-478207c30cf0.json](/data/javaagent/instrumentations/clickhouse-client-v1-0.5/clickhouse-client-v1-0.5-478207c30cf0.json)
- **Explore**: [/java-agent/instrumentation/clickhouse-client-v1-0.5](/java-agent/instrumentation/clickhouse-client-v1-0.5)