feat(metrics): warn when overwriting dimension

[dreamorosi]

Summary

Changes

Please provide a summary of what's being changed

When working with dimensions with Metrics, the default behavior is to overwrite existing dimensions when a new one with the same name/key is added. Customers have asked us to add a warning when this happens so that they can more easily troubleshoot issues rather than missing data.

Before

import { Metrics } from '@aws-lambda-powertools/metrics';

const metrics = new Metrics({ singleMetric: true });

metrics.addDimension('test', 'foo');
metrics.addDimension('test', 'bar'); // "bar" silently replaces "foo" as value

After

import { Metrics } from '@aws-lambda-powertools/metrics';

const metrics = new Metrics({ singleMetric: true });

metrics.addDimension('test', 'foo');
metrics.addDimension('test', 'bar'); // "bar" replaces "foo"

// warning: Dimension "test" has already been added. The previous value will be overwritten.

The PR also consolidates the implementation of addDimension() and addDimensions() with the latter now iterating through the dimensions and calling the former for each one, instead of bringing its own separate implementation. In doing so, it also fixes a bug in which the addDimensions() method didn't consider default dimensions when counting the total of allowed dimensions in EMF (30).

Please add the issue number below, if no issue is present the PR might get blocked and not be reviewed

Issue number: closes #3350

---

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
3.4% Duplication on New Code

See analysis details on SonarQube Cloud

[leandrodamascena]

I'm adding this one in Python as well. Thanks for working on this @dreamorosi

[leandrodamascena]

Hi @dreamorosi! Congrats on fixing this so quickly! I'll do the same in Python!

APPROVED!