fix(metrics): preserve default_tags when metric-specific tag is set in Datadog provider

[leandrodamascena]

Issue number: #2990

Summary

Changes

In this PR, we address an issue where default_tags were not preserved when adding metric-specific tags in the Datadog. We've implemented a fix to ensure that default_tags will be merged with metric-specific tags. We also fixed the precedence problem when default tags and metric-specific tags shared the same key, and now the metric-specific tags took precedence.

I also added datadog-lambda dependency as optional. We mistakenly removed this in some reviews of the original PR.

User experience

CODE

from aws_lambda_powertools.metrics.provider.datadog import DatadogMetrics, DatadogProvider
from aws_lambda_powertools.utilities.typing import LambdaContext

provider = DatadogProvider(flush_to_log=True)
metrics = DatadogMetrics(provider=provider)
metrics.set_default_tags(product="ticket")


@metrics.log_metrics  # ensures metrics are flushed upon request completion/failure
def lambda_handler(event: dict, context: LambdaContext):
    metrics.add_metric(name="SuccessfulBooking", value=1, flight="AB123")

Output before this fix:

{
    "m": "SuccessfulBooking",
    "v": 1,
    "e": 1692736997,
    "t": [
        "flight:AB123",
    ]
}

Output after this fix:

{
    "m": "SuccessfulBooking",
    "v": 1,
    "e": 1692736997,
    "t": [
        "product:ticket"
        "flight:AB123",
    ]
}

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.

[rubenfonseca]

stellar!

[sonarqubecloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

No Coverage information
No Duplication information

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.56%. Comparing base (2a8be25) to head (e8b3b8e).
⚠️ Report is 3036 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #2997   +/-   ##
========================================
  Coverage    96.56%   96.56%           
========================================
  Files          175      175           
  Lines         7825     7825           
  Branches      1476     1476           
========================================
  Hits          7556     7556           
  Misses         217      217           
  Partials        52       52           

☔ 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.