# Redisson

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

> OpenTelemetry Java agent instrumentation

This instrumentation enables database connection pool metrics for Redisson.

- **Name**: `redisson-metrics-3.18`
- **Scope**: `io.opentelemetry.redisson-metrics-3.18`
- **Target versions**: `org.redisson:redisson:[3.18.0,3.26.0)`
- **Library**: https://github.com/redisson/redisson

## Telemetry

### When `default`

**Metrics**

| Metric | Instrument | Type | Unit | Description |
| --- | --- | --- | --- | --- |
| `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.usage` | updowncounter | LONG_SUM | {connections} | The number of connections that are currently in state described by the state attribute. |

| Metric | Attributes |
| --- | --- |
| `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.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.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. |

| Metric | Attributes |
| --- | --- |
| `db.client.connection.count` | `db.client.connection.pool.name` (STRING), `db.client.connection.state` (STRING), `db.system.name` (STRING) |
| `db.client.connection.idle.min` | `db.client.connection.pool.name` (STRING), `db.system.name` (STRING) |
| `db.client.connection.limit` | `db.client.connection.pool.name` (STRING), `db.system.name` (STRING) |
| `db.client.connection.pending_requests` | `db.client.connection.pool.name` (STRING), `db.system.name` (STRING) |

## 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 (latest)**: [/data/javaagent/instrumentations/redisson-metrics-3.18/latest.json](/data/javaagent/instrumentations/redisson-metrics-3.18/latest.json)
- **JSON (pinned)**: [/data/javaagent/instrumentations/redisson-metrics-3.18/redisson-metrics-3.18-317c7fde5157.json](/data/javaagent/instrumentations/redisson-metrics-3.18/redisson-metrics-3.18-317c7fde5157.json)
- **Explore**: [/java-agent/instrumentation/redisson-metrics-3.18](/java-agent/instrumentation/redisson-metrics-3.18)