# Vibur DBCP

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables database connection pool metrics for Vibur DBCP data sources. When no pool name is explicitly configured, the JDBC URL and connection properties are used to derive `server.address[:server.port][/db.namespace]`. If no server address or database namespace is available, `vibur-dbcp` is used.

- **Name**: `vibur-dbcp-11.0`
- **Scope**: `io.opentelemetry.vibur-dbcp-11.0`
- **Target versions**: `org.vibur:vibur-dbcp:[11.0,)`
- **Library**: https://www.vibur.org/

## Telemetry

### When `default`

**Metrics**

| Metric | Instrument | Type | Unit | Description |
| --- | --- | --- | --- | --- |
| `db.client.connections.max` | updowncounter | LONG_SUM | {connections} | The maximum number of open connections allowed. |
| `db.client.connections.usage` | updowncounter | LONG_SUM | {connections} | The number of connections that are currently in state described by the state attribute. |

| Metric | Attributes |
| --- | --- |
| `db.client.connections.max` | `pool.name` (STRING) |
| `db.client.connections.usage` | `pool.name` (STRING), `state` (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.max` | updowncounter | LONG_SUM | {connection} | The maximum number of open connections allowed. |

| Metric | Attributes |
| --- | --- |
| `db.client.connection.count` | `db.client.connection.pool.name` (STRING), `db.client.connection.state` (STRING) |
| `db.client.connection.max` | `db.client.connection.pool.name` (STRING) |

## Data

- **JSON (latest)**: [/data/javaagent/instrumentations/vibur-dbcp-11.0/latest.json](/data/javaagent/instrumentations/vibur-dbcp-11.0/latest.json)
- **JSON (pinned)**: [/data/javaagent/instrumentations/vibur-dbcp-11.0/vibur-dbcp-11.0-587b1dce32da.json](/data/javaagent/instrumentations/vibur-dbcp-11.0/vibur-dbcp-11.0-587b1dce32da.json)
- **Explore**: [/java-agent/instrumentation/vibur-dbcp-11.0](/java-agent/instrumentation/vibur-dbcp-11.0)
