From d65d25b17aa26492097edeeef0e1b5c1b6710787 Mon Sep 17 00:00:00 2001 From: Anastasia Alexadrova Date: Thu, 30 Oct 2025 15:30:22 +0100 Subject: [PATCH] PBM-1608 Documented debugTrace option for GCS modified: docs/details/gcs.md modified: docs/reference/configuration-options.md --- docs/details/gcs.md | 7 +++++++ docs/reference/configuration-options.md | 7 +++++++ 2 files changed, 14 insertions(+) diff --git a/docs/details/gcs.md b/docs/details/gcs.md index 89465a2c..13914ef9 100644 --- a/docs/details/gcs.md +++ b/docs/details/gcs.md @@ -74,6 +74,13 @@ You can find [the configuration file template :octicons-link-external-16:](https hmacSecret: ``` +## Debug logging + +You can enable debug logging for different types of requests to GCS in Percona Backup for MongoDB. Percona Backup for MongoDB prints log messages in the `pbm logs` output so that you can debug and diagnose GCS request issues or failures. + +To enable S3 debug logging, set the `storage.gcs.debugTrace` option in Percona Backup for MongoDB configuration. This instructs PBM to also print HTTP trace from the MinIO storage in the logs. + + ## Adjust PBM configuration to use GCS Starting with version 2.10.0, PBM uses the Google Cloud SDK instead of AWS SDK. If you are upgrading from an earlier version, you need to adjust your PBM configuration as follows: diff --git a/docs/reference/configuration-options.md b/docs/reference/configuration-options.md index 4d6aedf8..67ac30ab 100644 --- a/docs/reference/configuration-options.md +++ b/docs/reference/configuration-options.md @@ -350,6 +350,13 @@ Each time PBM fails and tries again, it increases the wait time by multiplying i The maximum file size to be stored on the backup storage. If the file to upload exceeds this limit, PBM splits it in pieces, each of which falls within the defined limit. Read more about [Managing large backup files](../features/split-merge-backup.md). +### storage.gcs.debugTrace + +*Type*: boolean +*Required*: NO + +When set to `true`, activates detailed logging of HTTP requests and responses between PBM and GCS. + ## Filesystem storage options ```yaml