From fa020d011e9015558406e41d7fd07067f4caecc3 Mon Sep 17 00:00:00 2001 From: bean1352 Date: Tue, 1 Sep 2026 14:57:21 +0200 Subject: [PATCH 1/3] Document compact and migration log types --- maintenance-ops/monitoring-and-alerting.mdx | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/maintenance-ops/monitoring-and-alerting.mdx b/maintenance-ops/monitoring-and-alerting.mdx index 20064cae..179e7aa6 100644 --- a/maintenance-ops/monitoring-and-alerting.mdx +++ b/maintenance-ops/monitoring-and-alerting.mdx @@ -72,12 +72,16 @@ You have following options: ## Instance Logs -You can review logs for your PowerSync instance(s) to troubleshoot replication or sync service issues. Logs capture activity from the PowerSync Service and Replicator processes. +You can review logs for your PowerSync instance(s) to troubleshoot replication or sync service issues. Logs capture activity from the PowerSync Service and Replicator processes, as well as the jobs that run alongside them. * **Sync & API logs**: Reflect sync processes from the PowerSync Service to clients. * **Replicator logs**: Reflect replication activity from your source database to the PowerSync Service. +* **Compact logs**: Reflect the [compacting](/maintenance-ops/compacting-buckets) jobs that run daily to keep your instance's sync buckets efficient. + +* **Migration logs**: Reflect the migration job that prepares your instance's storage during a deploy. Check these when a deploy fails. + **Availability** @@ -104,7 +108,7 @@ Access instance logs through the [PowerSync Dashboard](https://dashboard.powersy You can manage logs with the following options: -* **Log Type**: Switch between **Sync & API logs** (from the PowerSync Service API container, which handles streaming sync connections as well as other API calls) and **Replication logs**. +* **Log Type**: Switch between **Sync & API logs** (from the PowerSync Service API container, which handles streaming sync connections as well as other API calls), **Replication logs**, **Compact logs**, and **Migration logs**. * **Log Levels**: Show or hide `Info`, `Error`, `Warn`, and `Debug` entries. * **Time Range**: Limit results to a relative window (last 15 minutes, last hour, etc.) or a custom range. The available window depends on your plan's retention period. You can also click the timestamp on any log entry to set it as the start or end of the time range. * **Sort Order**: Sort by newest or oldest first. From cf12a535705c63cc11569dd76ecb53fd2e5860d6 Mon Sep 17 00:00:00 2001 From: bean1352 Date: Tue, 1 Sep 2026 15:04:37 +0200 Subject: [PATCH 2/3] Link compact logs from the compacting page --- maintenance-ops/compacting-buckets.mdx | 2 ++ maintenance-ops/monitoring-and-alerting.mdx | 4 ++-- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/maintenance-ops/compacting-buckets.mdx b/maintenance-ops/compacting-buckets.mdx index ee896790..b00bcdf2 100644 --- a/maintenance-ops/compacting-buckets.mdx +++ b/maintenance-ops/compacting-buckets.mdx @@ -16,6 +16,8 @@ You can manually trigger compacting from the [PowerSync Dashboard](https://dashb - **Dashboard**: Select your project and instance, go to the **Settings** view, and click the **Compact** button in the "Compact operation history" section. - **CLI**: Run `powersync compact` against a linked Cloud instance. The CLI polls until the operation completes, with a default timeout of 30 minutes. Pass `--timeout=` to override, or `--timeout=0` to wait indefinitely. +When using PowerSync Cloud, you can view compact logs in the Dashboard's **Logs** view. See [Instance Logs](/maintenance-ops/monitoring-and-alerting#instance-logs). + [Defragmenting](/maintenance-ops/compacting-buckets#defragmenting) may still be required. ### Self-Hosted PowerSync diff --git a/maintenance-ops/monitoring-and-alerting.mdx b/maintenance-ops/monitoring-and-alerting.mdx index 179e7aa6..013f718e 100644 --- a/maintenance-ops/monitoring-and-alerting.mdx +++ b/maintenance-ops/monitoring-and-alerting.mdx @@ -78,9 +78,9 @@ You can review logs for your PowerSync instance(s) to troubleshoot replication o * **Replicator logs**: Reflect replication activity from your source database to the PowerSync Service. -* **Compact logs**: Reflect the [compacting](/maintenance-ops/compacting-buckets) jobs that run daily to keep your instance's sync buckets efficient. +* **Compact logs**: Reflect the [compacting](/maintenance-ops/compacting-buckets) jobs that keep your instance's sync buckets efficient, including the daily automatic job and any manually triggered runs. -* **Migration logs**: Reflect the migration job that prepares your instance's storage during a deploy. Check these when a deploy fails. +* **Migration logs**: Reflect the migration job that prepares your instance's storage during a deploy. Check these if a deploy fails at that step. **Availability** From e33f5dffd82a5a74d1b7cece6cf56dbaebadfbf9 Mon Sep 17 00:00:00 2001 From: bean1352 Date: Tue, 1 Sep 2026 15:06:37 +0200 Subject: [PATCH 3/3] Wording polish --- maintenance-ops/compacting-buckets.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/maintenance-ops/compacting-buckets.mdx b/maintenance-ops/compacting-buckets.mdx index b00bcdf2..4d8b8090 100644 --- a/maintenance-ops/compacting-buckets.mdx +++ b/maintenance-ops/compacting-buckets.mdx @@ -16,7 +16,7 @@ You can manually trigger compacting from the [PowerSync Dashboard](https://dashb - **Dashboard**: Select your project and instance, go to the **Settings** view, and click the **Compact** button in the "Compact operation history" section. - **CLI**: Run `powersync compact` against a linked Cloud instance. The CLI polls until the operation completes, with a default timeout of 30 minutes. Pass `--timeout=` to override, or `--timeout=0` to wait indefinitely. -When using PowerSync Cloud, you can view compact logs in the Dashboard's **Logs** view. See [Instance Logs](/maintenance-ops/monitoring-and-alerting#instance-logs). +When using PowerSync Cloud, compact logs are available in the Dashboard's **Logs** view. See [Instance Logs](/maintenance-ops/monitoring-and-alerting#instance-logs). [Defragmenting](/maintenance-ops/compacting-buckets#defragmenting) may still be required.