Skip to content

Commit 307b1b1

Browse files
authored
PgBouncer migration docs (#44)
1 parent b2c7f48 commit 307b1b1

6 files changed

Lines changed: 350 additions & 6 deletions

File tree

docs/configuration/pgdog.toml/databases.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,14 @@ Overrides the [`default_pool_size`](general.md#default_pool_size) setting. All c
8787
!!! note "Recommendation"
8888
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.
8989

90+
### `pooler_mode`
91+
92+
Overrides the [`pooler_mode`](general.md#pooler_mode) setting. Connections to this database will use this connection pool mode.
93+
94+
### `min_pool_size`
95+
96+
Overrides the [`min_pool_size`](general.md#min_pool_size) setting. The connection pool will maintain at minimum this many connections.
97+
9098
### `statement_timeout`
9199

92100
This setting configures the `statement_timeout` connection parameter on all connections to Postgres for this database.

docs/configuration/pgdog.toml/general.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,12 @@ Maximum amount of time new clients have to complete authentication. Clients that
212212

213213
Default: **`60_000`** (60s)
214214

215+
### `server_lifetime`
216+
217+
Maximum amount of time a server connection is allowed to exist. Any connections exceeding this limit will be closed once they are checked back into the pool.
218+
219+
Default: **`86400000`** (24h)
220+
215221
## Load balancer
216222

217223
### `load_balancing_strategy`
@@ -401,3 +407,11 @@ Default: **`true`** (enabled)
401407
How often to calculate averages shown in `SHOW STATS` [admin](../../administration/index.md) command and the [Prometheus](../../features/metrics.md) metrics.
402408

403409
Default: **`15_000`** (15s)
410+
411+
## DNS
412+
413+
### `dns_ttl`
414+
415+
Overrides the TTL set on DNS records received from DNS servers. Allows for faster failover when the primary/replica hostnames are changed by the database hosting provider.
416+
417+
Default: **none** (disabled)

docs/configuration/pgdog.toml/network.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To be consistent with the rest of PgDog documentation, units of time are in mill
2020
!!! note "Support for keep-alives"
2121
Not all networks support or play well with TCP keep-alives. If you see an increased number of dropped connections after enabling these settings, you may have to disable them.
2222

23-
### `keepalives`
23+
### `keepalive`
2424

2525
Enable TCP keep-alives. When enabled, idle client & server connections will send keep-alive packets to make sure the TCP connections are healthy.
2626

docs/migrating-to-pgdog/.pages

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
title: Migrating to PgDog

0 commit comments

Comments
 (0)