Vert.x SQL Client
OpenTelemetry Java agent instrumentation
This instrumentation enables database client spans and database client metrics for Vert.x SQL Client operations.
- Name:
vertx-sql-client-4.0 - Scope:
io.opentelemetry.vertx-sql-client-4.0 - Target versions:
io.vertx:vertx-sql-client:[4.0.0,5) - Library: https://github.com/eclipse-vertx/vertx-sql-client
Telemetry
When default
Spans
| Span kind | Attributes |
|---|---|
| CLIENT | db.name (STRING), db.operation (STRING), db.sql.table (STRING), db.statement (STRING), db.user (STRING), peer.service (STRING), server.address (STRING), server.port (LONG) |
When otel.semconv-stability.opt-in=database,service.peer
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), server.address (STRING), server.port (LONG) |
Spans
| Span kind | Attributes |
|---|---|
| CLIENT | db.namespace (STRING), db.operation.batch.size (LONG), db.query.summary (STRING), db.query.text (STRING), db.system.name (STRING), error.type (STRING), server.address (STRING), server.port (LONG), service.peer.name (STRING) |
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.vertx-sql-client.query-sanitization.enabled | boolean | Enables query sanitization for Vert.x SQL client queries. Overrides otel.instrumentation.common.db.query-sanitization.enabled for this instrumentation; when unset, that setting applies. | |
otel.instrumentation.vertx-sql-client.statement-sanitizer.enabled | boolean | Deprecated: use otel.instrumentation.vertx-sql-client.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). |