From a954a32e35133c24154334f31dae051eb9d45f6b Mon Sep 17 00:00:00 2001 From: Justin George Date: Wed, 8 Oct 2025 12:55:26 -0700 Subject: [PATCH 1/4] Note connection recommendation --- docs/configuration/pgdog.toml/general.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/configuration/pgdog.toml/general.md b/docs/configuration/pgdog.toml/general.md index 83a94c6..5352bc5 100644 --- a/docs/configuration/pgdog.toml/general.md +++ b/docs/configuration/pgdog.toml/general.md @@ -38,6 +38,9 @@ Default: **`0`** (current thread runtime) Default maximum number of server connections per database pool. The pooler will not open more than this many PostgreSQL database connections when serving clients. +!!! note + We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios. + Default: **`10`** ### `min_pool_size` From 666f1a003686756a9b739a987af3f625197c3fde Mon Sep 17 00:00:00 2001 From: Justin George Date: Wed, 8 Oct 2025 12:56:05 -0700 Subject: [PATCH 2/4] pool_size note --- docs/configuration/pgdog.toml/databases.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/configuration/pgdog.toml/databases.md b/docs/configuration/pgdog.toml/databases.md index 4c420c9..d2183dc 100644 --- a/docs/configuration/pgdog.toml/databases.md +++ b/docs/configuration/pgdog.toml/databases.md @@ -84,6 +84,9 @@ Default: **`0`** Overrides the [`default_pool_size`](general.md#default_pool_size) setting. All connection pools for this database will open at most this many connections to Postgres. +!!! note + We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios. + ### `statement_timeout` This setting configures the `statement_timeout` connection parameter on all connections to Postgres for this database. From 02cc2f9a9b23a1536a9b945bfbc95868df43fb29 Mon Sep 17 00:00:00 2001 From: Justin George Date: Wed, 8 Oct 2025 13:25:12 -0700 Subject: [PATCH 3/4] Update docs/configuration/pgdog.toml/databases.md Co-authored-by: Lev Kokotov --- docs/configuration/pgdog.toml/databases.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/pgdog.toml/databases.md b/docs/configuration/pgdog.toml/databases.md index d2183dc..5a71cb5 100644 --- a/docs/configuration/pgdog.toml/databases.md +++ b/docs/configuration/pgdog.toml/databases.md @@ -84,7 +84,7 @@ Default: **`0`** Overrides the [`default_pool_size`](general.md#default_pool_size) setting. All connection pools for this database will open at most this many connections to Postgres. -!!! note +!!! note "Recommendation" We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios. ### `statement_timeout` From c07c0b3284536f88bba7812665451dee18420048 Mon Sep 17 00:00:00 2001 From: Justin George Date: Wed, 8 Oct 2025 13:25:18 -0700 Subject: [PATCH 4/4] Update docs/configuration/pgdog.toml/general.md Co-authored-by: Lev Kokotov --- docs/configuration/pgdog.toml/general.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/configuration/pgdog.toml/general.md b/docs/configuration/pgdog.toml/general.md index 5352bc5..15a904b 100644 --- a/docs/configuration/pgdog.toml/general.md +++ b/docs/configuration/pgdog.toml/general.md @@ -38,7 +38,7 @@ Default: **`0`** (current thread runtime) Default maximum number of server connections per database pool. The pooler will not open more than this many PostgreSQL database connections when serving clients. -!!! note +!!! note "Recommendation" We strongly recommend keeping this value well below the supported connections of the backend database(s) to allow connections for maintenance in high load scenarios. Default: **`10`**