diff --git a/docs/tutorials/aws/boto3-configuration.md b/docs/tutorials/aws/boto3-configuration.md index c49679b1..c8caa242 100644 --- a/docs/tutorials/aws/boto3-configuration.md +++ b/docs/tutorials/aws/boto3-configuration.md @@ -32,3 +32,14 @@ Prowler's AWS Provider uses the Boto3 [Standard](https://boto3.amazonaws.com/v1/ - Retry attempts on nondescriptive, transient error codes. Specifically, these HTTP status codes: 500, 502, 503, 504. - Any retry attempt will include an exponential backoff by a base factor of 2 for a maximum backoff time of 20 seconds. + +## Notes for validating retry attempts + +If you are making changes to Prowler, and want to validate if requests are being retried or given up on, you can take the following approach + +* Run prowler with `--log-level DEBUG` and `--log-file debuglogs.txt` +* Search for retry attempts using `grep -i 'Retry needed' debuglogs.txt` + +This is based off of the [AWS documentation](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/retries.html#checking-retry-attempts-in-your-client-logs), which states that if a retry is performed, you will see a message starting with "Retry needed". + +You can determine the total number of calls made using `grep -i 'Sending http request' debuglogs.txt | wc -l`