HikariCP
OpenTelemetry Java agent instrumentation
This instrumentation enables database connection pool metrics for HikariCP.
- Name:
hikaricp-3.0 - Scope:
io.opentelemetry.hikaricp-3.0 - Target versions:
com.zaxxer:HikariCP:[3.0.0,) - Library: https://github.com/brettwooldridge/HikariCP
Telemetry
When default
Metrics
| Metric | Instrument | Type | Unit | Description |
|---|---|---|---|---|
db.client.connections.create_time | histogram | HISTOGRAM | ms | The time it took to create a new connection. |
db.client.connections.idle.min | updowncounter | LONG_SUM | {connections} | The minimum number of idle open connections allowed. |
db.client.connections.max | updowncounter | LONG_SUM | {connections} | The maximum number of open connections allowed. |
db.client.connections.pending_requests | updowncounter | LONG_SUM | {requests} | The number of pending requests for an open connection, cumulative for the entire pool. |
db.client.connections.timeouts | counter | LONG_SUM | {timeouts} | The number of connection timeouts that have occurred trying to obtain a connection from the pool. |
db.client.connections.usage | updowncounter | LONG_SUM | {connections} | The number of connections that are currently in state described by the state attribute. |
db.client.connections.use_time | histogram | HISTOGRAM | ms | The time between borrowing a connection and returning it to the pool. |
db.client.connections.wait_time | histogram | HISTOGRAM | ms | The time it took to obtain an open connection from the pool. |
| Metric | Attributes |
|---|---|
db.client.connections.create_time | pool.name (STRING) |
db.client.connections.idle.min | pool.name (STRING) |
db.client.connections.max | pool.name (STRING) |
db.client.connections.pending_requests | pool.name (STRING) |
db.client.connections.timeouts | pool.name (STRING) |
db.client.connections.usage | pool.name (STRING), state (STRING) |
db.client.connections.use_time | pool.name (STRING) |
db.client.connections.wait_time | pool.name (STRING) |
When otel.semconv-stability.opt-in=database
Metrics
| Metric | Instrument | Type | Unit | Description |
|---|---|---|---|---|
db.client.connection.count | updowncounter | LONG_SUM | {connection} | The number of connections that are currently in state described by the state attribute. |
db.client.connection.create_time | histogram | HISTOGRAM | s | The time it took to create a new connection. |
db.client.connection.idle.min | updowncounter | LONG_SUM | {connection} | The minimum number of idle open connections allowed. |
db.client.connection.limit | updowncounter | LONG_SUM | {connection} | The maximum number of open connections allowed. |
db.client.connection.pending_requests | updowncounter | LONG_SUM | {request} | The number of current pending requests for an open connection. |
db.client.connection.timeouts | counter | LONG_SUM | {timeout} | The number of connection timeouts that have occurred trying to obtain a connection from the pool. |
db.client.connection.use_time | histogram | HISTOGRAM | s | The time between borrowing a connection and returning it to the pool. |
db.client.connection.wait_time | histogram | HISTOGRAM | s | The time it took to obtain an open connection from the pool. |
| Metric | Attributes |
|---|---|
db.client.connection.count | db.client.connection.pool.name (STRING), db.client.connection.state (STRING) |
db.client.connection.create_time | db.client.connection.pool.name (STRING) |
db.client.connection.idle.min | db.client.connection.pool.name (STRING) |
db.client.connection.limit | db.client.connection.pool.name (STRING) |
db.client.connection.pending_requests | db.client.connection.pool.name (STRING) |
db.client.connection.timeouts | db.client.connection.pool.name (STRING) |
db.client.connection.use_time | db.client.connection.pool.name (STRING) |
db.client.connection.wait_time | db.client.connection.pool.name (STRING) |