Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 8 additions & 8 deletions docs/enterprise_edition/plans.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,13 +16,13 @@ Query plan collection is disabled by default and can be enabled in `pgdog.toml`:
```toml
[query_stats]
enabled = true
query_plan_threshold = 100 # Queries slower than 100ms will be planned.
query_plans_threshold = 100 # Queries slower than 100ms will be planned.
```
=== "Helm chart"
```yaml
queryStats:
enabled: true
queryPlanThreshold: 100
queryPlansThreshold: 100
```

The plans are stored in memory and deduplicated by _normalized_ SQL of the query. This means that queries with different parameters will be tied to the same query plan, making sure PgDog doesn't plan the same query multiple times.
Expand All @@ -33,30 +33,30 @@ The query plan cache is configurable:

| Argument | Description | Example |
|-|-|-|
| `query_plan_threshold` | Minimum query runtime that triggers a query plan (in ms). | `100` |
| `query_plans_threshold` | Minimum query runtime that triggers a query plan (in ms). | `100` |
| `query_plans_sample_rate` | Percentage of all queries executed through PgDog that will be planned, irrespective of their runtime (between 0.0 and 1.0). | `0.5` |
| `query_plans_cache` | Maximum number of entries in the in-memory plan cache. | `500` |
| `query_plan_max_age` | Query plans older than this are considered stale and will be replanned if the query is executed again (in ms). | `15_000` |
| `query_plans_max_age` | Query plans older than this are considered stale and will be replanned if the query is executed again (in ms). | `15_000` |

##### Example

=== "pgdog.toml"
```toml
[query_stats]
enabled = true
query_plan_threshold = 100
query_plans_threshold = 100
query_plans_sample_rate = 0.5
query_plans_cache = 1_000
query_plan_max_age = 15_000
query_plans_max_age = 15_000
```
=== "Helm chart"
```yaml
queryStats:
enabled: true
queryPlanThreshold: 100
queryPlansThreshold: 100
queryPlansSampleRate: 0.5
queryPlansCache: 1000
queryPlanMaxAge: 15000
queryPlansMaxAge: 15000
```

### Admin database
Expand Down
4 changes: 2 additions & 2 deletions docs/examples/control_plane/docker-compose.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
x-pgdog: &pgdog
image: ghcr.io/pgdogdev/pgdog-enterprise:v2026-05-28
image: ghcr.io/pgdogdev/pgdog-enterprise:v2026-06-15
command: ["pgdog", "--config", "/etc/pgdog/pgdog.toml", "--users", "/etc/secrets/pgdog/users.toml"]
mem_limit: 1g
environment:
Expand Down Expand Up @@ -32,7 +32,7 @@ services:
image: redis:7

control:
image: ghcr.io/pgdogdev/pgdog-enterprise/control:v2026-05-28
image: ghcr.io/pgdogdev/pgdog-enterprise/control:v2026-06-15
ports:
- "8099:8080"
environment:
Expand Down
2 changes: 1 addition & 1 deletion main.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
# Latest released tag for the Enterprise Docker images. Update this in one
# place; reference it in docs with {{ enterprise_tag }}. Can be overridden at
# build time with the ENTERPRISE_TAG environment variable.
ENTERPRISE_TAG = os.environ.get("ENTERPRISE_TAG", "v2026-06-12")
ENTERPRISE_TAG = os.environ.get("ENTERPRISE_TAG", "v2026-06-15")


def define_env(env):
Expand Down
Loading