chore(logger): clear prev request buffers in manual mode

[leandrodamascena]

Issue number: #6310

Summary

Changes

The PR updates the default behavior of the log buffering feature in the Logger utility to clear existing buffers whenever creating the buffer for a new request. This was already the case when using decorators or flush_buffer method.

This PR aligns the behavior also for manual mode, aka when customers are not using either of the two patterns above. This will help reduce the likelihood that customers forget to clear log buffers and risk exhausting the memory available in the sandbox.

The PR also adds an additional item to the feature FAQs to document how the Logger calculates the size of each log entry. This should address questions from customers on the topic, which came in from early adopters.

User experience

Please share what the user experience looks like before and after this change

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.32%. Comparing base (c9c4142) to head (d5dffce).
Report is 2 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #6314   +/-   ##
========================================
  Coverage    96.32%   96.32%           
========================================
  Files          242      242           
  Lines        11674    11676    +2     
  Branches       864      865    +1     
========================================
+ Hits         11245    11247    +2     
  Misses         336      336           
  Partials        93       93           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[leandrodamascena]

e2e is green: https://github.com/aws-powertools/powertools-lambda-python/actions/runs/13969172894/job/39106522909

[dreamorosi]

LGTM