diff --git a/docs/details/azure.md b/docs/details/azure.md index e9f963ba..acc36186 100644 --- a/docs/details/azure.md +++ b/docs/details/azure.md @@ -80,3 +80,17 @@ storage: ``` For the description of configuration options, see [Configuration file options](../reference/configuration-options.md). + + +## Upload retries + +You can set up the number of attempts for Percona Backup for MongoDB to upload data to Microsoft Azure storage as well as the min and max time to wait for the next retry. Set the options `storage.azure.retryer.numMaxRetries`, `storage.azure.retryer.minRetryDelay` and `storage.azure.retryer.maxRetryDelay` in Percona Backup for MongoDB configuration. + +```yaml +retryer: + numMaxRetries: 3 + minRetryDelay: 800ms + maxRetryDelay: 60s +``` + +This upload retry increases the chances of data upload completion in cases of unstable connection. \ No newline at end of file diff --git a/docs/reference/configuration-options.md b/docs/reference/configuration-options.md index 1bb60dcc..de5521fe 100644 --- a/docs/reference/configuration-options.md +++ b/docs/reference/configuration-options.md @@ -544,6 +544,10 @@ storage: credentials: key: maxObjSizeGB: 194560 + retryer: + numMaxRetries: 3 + minRetryDelay: 800ms + maxRetryDelay: 60s ``` ### storage.azure.account @@ -597,6 +601,30 @@ Your access key to authorize access to data in your storage account. 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.azure.retryer.numMaxRetries + +*Type*: int
+*Required*: NO
+*Default*: 3 + +The maximum number of retries to upload data to Microsoft Azure storage. A zero value means no retries will be performed. + +### storage.azure.retryer.minRetryDelay + +*Type*: time.Duration
+*Required*: NO
+*Default*: 800ms + +The minimum time to wait before the next retry, specified as a `time.Duration`. Units like ms, s, etc., are supported. Defaults to nanoseconds if no unit is provided. + + +### storage.azure.retryer.maxRetryDelay + +*Type*: time.Duration
+*Required*: NO
+*Default*: 60s + +The maximum time to wait before the next retry, specified as a `time.Duration`. Units like ms, s, etc., are supported. Defaults to nanoseconds if no unit is provided. ## Alibaba Cloud OSS storage options