# Tomcat JDBC

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables database connection pool metrics for Tomcat JDBC.

- **Name**: `tomcat-jdbc-8.5`
- **Scope**: `io.opentelemetry.tomcat-jdbc`
- **Target versions**: `org.apache.tomcat:tomcat-jdbc:[8.5.0,)`
- **Library**: https://tomcat.apache.org/tomcat-8.5-doc/jdbc-pool.html

## Telemetry

- **Metrics**: `db.client.connections.idle.max`, `db.client.connections.idle.min`, `db.client.connections.max`, `db.client.connections.pending_requests`, `db.client.connections.usage`, `db.client.connection.count`, `db.client.connection.idle.max`, `db.client.connection.idle.min`, `db.client.connection.max`, `db.client.connection.pending_requests`

## Configuration

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `otel.semconv-stability.opt-in` | list |  | Opt-in to emit stable semantic conventions instead of the old experimental semantic conventions. Accepts a comma-separated list of semantic convention groups (e.g., `database`, `http`, `messaging`). Use `<group>/dup` to emit both old and new conventions simultaneously. Stable semantic conventions will become the default in version 3.0 of the agent. |

## Data

- **JSON**: [/data/javaagent/instrumentations/tomcat-jdbc-8.5/tomcat-jdbc-8.5-2de4ab1ac193.json](/data/javaagent/instrumentations/tomcat-jdbc-8.5/tomcat-jdbc-8.5-2de4ab1ac193.json)
- **Explore**: [/java-agent/instrumentation/tomcat-jdbc-8.5](/java-agent/instrumentation/tomcat-jdbc-8.5)