From 0df51e51d3177c8f9466b6ed273c15796e9272f6 Mon Sep 17 00:00:00 2001 From: Jason Stirnaman Date: Thu, 10 Jul 2025 12:11:21 -0500 Subject: [PATCH] fix(clustered): note snapshot storage and utilization costs:\ \ - Note callout: Focuses on the storage cost implications of enabling the setting - Caution callout: Focuses on the risk of making recovery points unusable when disabled --- .../influxdb3/clustered/admin/backup-restore.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/content/influxdb3/clustered/admin/backup-restore.md b/content/influxdb3/clustered/admin/backup-restore.md index e6eeca7c3..f85583c7e 100644 --- a/content/influxdb3/clustered/admin/backup-restore.md +++ b/content/influxdb3/clustered/admin/backup-restore.md @@ -161,11 +161,16 @@ snapshots. The default is `'false'`. Set to `'true'`: INFLUXDB_IOX_DELETE_USING_CATALOG_BACKUP_DATA_SNAPSHOT_FILES: 'true' ``` +> [!Note] +> #### Storage utilization and costs +> +> Enabling this setting retains Parquet files referenced in snapshots, increasing +> object storage utilization and costs. The longer you retain snapshots, the more +> storage space and costs you incur. + > [!Caution] -> If set to `false` (the default) with snapshots enabled, the Garbage Collector does not check -> to see if a Parquet file is associated with existing snapshots before removing -> the Parquet file from the object store. This could result in deleting Parquet -> files needed to restore the cluster to a recovery point. +> If set to `false` (the default), the Garbage Collector may delete Parquet +> files needed for snapshot restoration, making recovery points unusable. #### INFLUXDB_IOX_KEEP_HOURLY_CATALOG_BACKUP_FILE_LISTS @@ -454,7 +459,7 @@ using Catalog store snapshots: ```bash kubectl scale --namespace influxdb --replicas=1 statefulset/iox-shared-compactor kubectl scale --namespace influxdb --replicas=2 deployment/iox-shared-querier - kubectl scale --namespace influxdb --replicas=1 deployment/global-router + kubectl scale --namespace influxdb --replicas=3 deployment/global-router kubectl scale --namespace influxdb --replicas=1 deployment/global-gc ```