From b89a11881f7c93f55634b6db0eeaafc36f653a83 Mon Sep 17 00:00:00 2001 From: meskill <8974488+meskill@users.noreply.github.com> Date: Thu, 19 Mar 2026 20:35:18 +0000 Subject: [PATCH] fix(metrics): maxwait description --- docs/administration/pools.md | 4 ++-- docs/enterprise_edition/metrics.md | 2 +- docs/features/metrics.md | 2 +- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/administration/pools.md b/docs/administration/pools.md index 738ce97..7631a85 100644 --- a/docs/administration/pools.md +++ b/docs/administration/pools.md @@ -26,8 +26,8 @@ The following information is returned for each connection pool (user/database pa | `sv_active` | Number of checked out (used) server connections in the pool. | `12` | | `sv_idle_xact` | Number of idle-in-transaction server connections in the pool. | `0` | | `sv_total` | Total number of server connections in the pool. | `20` | -| `maxwait` | Maximum wait time for connections. | `30` | -| `maxwait_us` | Maximum wait time for connections in microseconds. | `30000000` | +| `maxwait` | How long the first (oldest) client in the queue has waited, in seconds. | `30` | +| `maxwait_us` | Microsecond part of the `maxwait` value. | `30000000` | | `pool_mode` | Connection pooling mode. | `transaction` | | `paused` | The pool is paused and won't issue connections until resumed. | `f` | | `banned` | The pool is blocked from serving more clients. | `f` | diff --git a/docs/enterprise_edition/metrics.md b/docs/enterprise_edition/metrics.md index 1585633..ac02453 100644 --- a/docs/enterprise_edition/metrics.md +++ b/docs/enterprise_edition/metrics.md @@ -29,5 +29,5 @@ The default value is **1 second**, which should be sufficient to debug most prod Once the metrics reach the control plane, they are pushed down to the web dashboard via a real-time connection. Per-minute aggregates are computed in the background and stored in a separate PostgreSQL database, which provides a historical view into overall database performance.
- How PgDog works + PgDog Real-time Metrics
diff --git a/docs/features/metrics.md b/docs/features/metrics.md index d1200eb..c5a1d8a 100644 --- a/docs/features/metrics.md +++ b/docs/features/metrics.md @@ -75,7 +75,7 @@ The following metrics are exported via the OpenMetrics endpoint: | `sv_active` | Servers currently serving client requests. | `gauge` | | `sv_idle` | Servers available for clients to use. | `gauge` | | `sv_idle_xact` | Servers currently idle in transaction. | `gauge` | -| `maxwait` | How long clients have been waiting for a connection (in seconds). | `gauge` | +| `maxwait` | How long the first (oldest) client in the queue has waited (in seconds). | `gauge` | | `errors` | Errors that connections in the pool have experienced. | `counter` | | `out_of_sync` | Connections that have been returned to the pool in a broken state. | `counter` | | `total_xact_count` | Total number of executed transactions. | `counter` |