fix(metrics): maxwait description (#60)

Author: meskill

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` |

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.
 
 <center>
-  <img src="/images/ee/metrics.png" width="100%" alt="How PgDog works" class="screenshot" />
+  <img src="/images/ee/metrics.png" width="100%" alt="PgDog Real-time Metrics" class="screenshot" />
 </center>

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` |