ClickHouse Java Client
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
When default
Spans
| Span kind | Attributes |
|---|---|
| CLIENT | db.name (STRING), db.operation (STRING), db.statement (STRING), db.system (STRING), server.address (STRING), server.port (LONG) |
When otel.semconv-stability.opt-in=database
Metrics
| Metric | Instrument | Type | Unit | Description |
|---|---|---|---|---|
db.client.operation.duration | histogram | HISTOGRAM | s | Duration of database client operations. |
| Metric | Attributes |
|---|---|
db.client.operation.duration | db.namespace (STRING), db.query.summary (STRING), db.system.name (STRING), network.peer.address (STRING), network.peer.port (LONG), server.address (STRING), server.port (LONG) |
Spans
| Span kind | Attributes |
|---|---|
| CLIENT | db.namespace (STRING), db.query.summary (STRING), db.query.text (STRING), db.system.name (STRING), error.type (STRING), network.peer.address (STRING), network.peer.port (LONG), server.address (STRING), server.port (LONG) |
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
java.common.database.statement_sanitizer.enabled | boolean | true | Deprecated: use java.common.db.query_sanitization.enabled instead. It is ignored under v3 preview. |
otel.instrumentation.common.db-statement-sanitizer.enabled | boolean | true | Deprecated: use otel.instrumentation.common.db.query-sanitization.enabled instead. It is ignored under v3 preview and will be removed in 3.0. |
otel.instrumentation.common.db.query-sanitization.enabled | boolean | true | Enables query sanitization for database queries. |
otel.instrumentation.clickhouse.query-sanitization.enabled | boolean | Enables query sanitization for ClickHouse queries. Overrides otel.instrumentation.common.db.query-sanitization.enabled for this instrumentation; when unset, that setting applies. | |
otel.instrumentation.clickhouse.statement-sanitizer.enabled | boolean | Deprecated: use otel.instrumentation.clickhouse.query-sanitization.enabled instead. It is ignored under v3 preview and will be removed in 3.0. When unset, this setting falls back to otel.instrumentation.common.db.query-sanitization.enabled (including its deprecated aliases). |