From b724499377d1560a1522a1524f63b54904c31e03 Mon Sep 17 00:00:00 2001 From: Lev Kokotov Date: Mon, 6 Apr 2026 09:32:23 -0700 Subject: [PATCH 1/2] refactor: reword some sentences --- docs/enterprise_edition/insights/.pages | 4 ++++ docs/enterprise_edition/insights/active_queries.md | 4 ++-- docs/enterprise_edition/insights/errors.md | 2 +- docs/enterprise_edition/insights/index.md | 4 ++-- docs/enterprise_edition/insights/statistics.md | 4 ++-- 5 files changed, 11 insertions(+), 7 deletions(-) create mode 100644 docs/enterprise_edition/insights/.pages diff --git a/docs/enterprise_edition/insights/.pages b/docs/enterprise_edition/insights/.pages new file mode 100644 index 0000000..52699f9 --- /dev/null +++ b/docs/enterprise_edition/insights/.pages @@ -0,0 +1,4 @@ +title: Query insights +nav: + - index.md + - ... diff --git a/docs/enterprise_edition/insights/active_queries.md b/docs/enterprise_edition/insights/active_queries.md index 188e5dd..044e68a 100644 --- a/docs/enterprise_edition/insights/active_queries.md +++ b/docs/enterprise_edition/insights/active_queries.md @@ -4,7 +4,7 @@ icon: material/play-circle # Active queries -PgDog Enterprise provides a real-time view into queries currently executing on its PostgreSQL connections. This is accessible in two places: +PgDog provides a real-time view into queries currently executing on its PostgreSQL connections. This is accessible in two places: 1. [`SHOW ACTIVE_QUERIES`](#admin-database) admin command 2. [Activity](#web-ui) view in the dashboard @@ -54,6 +54,6 @@ If you're running multiple instances of PgDog, active queries from all instances ### Parameters -If your application is using prepared statements (or just placeholders in queries), the parameters for these queries are not shown and will not be sent to the control plane. +If your application is using prepared statements (or just placeholders in queries), the parameters for these queries are not shown and will not be sent to the control plane. If your application is using simple statements (parameters in query text), PgDog will normalize the queries, removing values and replacing them with parameter symbols (e.g., `$1`). This is to make sure no sensitive data leaves the database network. diff --git a/docs/enterprise_edition/insights/errors.md b/docs/enterprise_edition/insights/errors.md index d48d151..63dfcb6 100644 --- a/docs/enterprise_edition/insights/errors.md +++ b/docs/enterprise_edition/insights/errors.md @@ -4,7 +4,7 @@ icon: material/alert-circle # Errors -PgDog Enterprise tracks query errors returned by PostgreSQL, providing a real-time view into recently encountered issues like syntax errors, missing columns, or lock timeouts. +PgDog tracks query errors returned by PostgreSQL, providing a real-time view into recently encountered issues like syntax errors, missing columns, or lock timeouts. ## Admin database diff --git a/docs/enterprise_edition/insights/index.md b/docs/enterprise_edition/insights/index.md index aea4b90..5cc39bc 100644 --- a/docs/enterprise_edition/insights/index.md +++ b/docs/enterprise_edition/insights/index.md @@ -4,11 +4,11 @@ icon: material/lightbulb-on # Query insights -PgDog Enterprise provides visibility into all queries that it serves, which allows it to analyze and report how those queries perform, in real-time. +PgDog provides visibility into all queries that it serves, which allows it to analyze and report how those queries perform, in real-time. ## Telemetry -PgDog Enterprise collects the following telemetry: +PgDog collects and displays the following telemetry: | Telemetry | Frequency | Description | |-|-|-| diff --git a/docs/enterprise_edition/insights/statistics.md b/docs/enterprise_edition/insights/statistics.md index bba0644..fdbc2ac 100644 --- a/docs/enterprise_edition/insights/statistics.md +++ b/docs/enterprise_edition/insights/statistics.md @@ -4,7 +4,7 @@ icon: material/chart-bar # Query statistics -PgDog Enterprise collects detailed per-query statistics, similar to PostgreSQL's `pg_stat_statements`, with extra information useful for debugging application performance. +PgDog collects detailed per-query statistics, similar to PostgreSQL's `pg_stat_statements`, with extra information useful for debugging application performance. These are viewable and searchable in the [control plane UI](../control_plane/index.md) and in the [admin database](#admin-database). ## How it works @@ -13,7 +13,7 @@ All queries are normalized (parameters replaced with `$1`, `$2`, etc.) and group This data is accessible via two mediums: 1. [Admin database](#admin-database) -2. The Insights page in the web UI of the [control plane](../control_plane/index.md) +2. The Query insights page in the web UI of the [control plane](../control_plane/index.md) ### Admin database From 5412a59d673a9fd5d9a4eb53f7559af33330506a Mon Sep 17 00:00:00 2001 From: Lev Kokotov Date: Mon, 6 Apr 2026 09:33:28 -0700 Subject: [PATCH 2/2] words --- docs/enterprise_edition/insights/statistics.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/enterprise_edition/insights/statistics.md b/docs/enterprise_edition/insights/statistics.md index fdbc2ac..dc738fd 100644 --- a/docs/enterprise_edition/insights/statistics.md +++ b/docs/enterprise_edition/insights/statistics.md @@ -13,7 +13,7 @@ All queries are normalized (parameters replaced with `$1`, `$2`, etc.) and group This data is accessible via two mediums: 1. [Admin database](#admin-database) -2. The Query insights page in the web UI of the [control plane](../control_plane/index.md) +2. The Insights page in the web UI of the [control plane](../control_plane/index.md) ### Admin database