fix(logger): strip xray_trace_id when explicitly disabled

[heitorlessa]

Issue number: #2835

Summary

This PR addresses the issue of X-Ray Trace ID key (xray_trace_id) not being removed despite being explicitly disabled.

Changes

Please provide a summary of what's being changed

User experience

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

bla.py

logger = Logger(xray_trace_id=None)
logger.info("blah")

Setting X-Ray Trace ID env var produces no effect when explicitly disabling at Logger constructor (as expected now)

_X_AMZN_TRACE_ID="Root=1-5759e988-bd862e3fe1be46a994272793;Parent=53995c3f42cd8ad8;Sampled=1" python bla.py

Output

{
    "level": "INFO",
    "location": "<module>:4",
    "message": "blah",
    "timestamp": "2023-07-26 14:17:53,765+0200",
    "service": "service_undefined"
}

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.

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (37c3c62) 97.57% compared to head (b123adb) 97.57%.
Report is 1 commits behind head on develop.

❗ Your organization is not using the GitHub App Integration. As a result you may experience degraded service beginning May 15th. Please install the Github App Integration for your organization. Read more.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #2852   +/-   ##
========================================
  Coverage    97.57%   97.57%           
========================================
  Files          162      162           
  Lines         7473     7475    +2     
  Branches      1416     1416           
========================================
+ Hits          7292     7294    +2     
  Misses         133      133           
  Partials        48       48           

Files Changed	Coverage Δ
aws_lambda_powertools/logging/formatter.py	100.00% <100.00%> (ø)

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

[leandrodamascena]

Hei @heitorlessa! I tried to find information about this parameter xray_trace_id in our documentation and I couldn't find. Should we add a section or banner in the Advanced section to explain this?

[heitorlessa]

It's documented under Overriding Log Record: https://docs.powertools.aws.dev/lambda/python/latest/core/logger/#overriding-log-records

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
0.5% Duplication