feat(metrics): add Datadog observability provider (#2906)

Co-authored-by: Leandro Damascena <lcdama@amazon.pt>
Co-authored-by: heitorlessa <lessa@amazon.co.uk>

.markdownlintignore

@@ -0,0 +1,2 @@
+docs/core/metrics/index.md
+includes/abbreviations.md

aws_lambda_powertools/metrics/metrics.py

@@ -51,6 +51,8 @@ def lambda_handler():
         service name to be used as metric dimension, by default "service_undefined"
     namespace : str, optional
         Namespace for metrics
+    provider: AmazonCloudWatchEMFProvider, optional
+        Pre-configured AmazonCloudWatchEMFProvider provider
 
     Raises
     ------

aws_lambda_powertools/metrics/provider/base.py

@@ -179,8 +179,13 @@ def handler(event, context):
         e
             Propagate error received
         """
+        extra_args = {}
 
-        default_dimensions = kwargs.get("default_dimensions")
+        if kwargs.get("default_dimensions"):
+            extra_args.update({"default_dimensions": kwargs.get("default_dimensions")})
+
+        if kwargs.get("default_tags"):
+            extra_args.update({"default_tags": kwargs.get("default_tags")})
 
         # If handler is None we've been called with parameters
         # Return a partial function with args filled
@@ -190,7 +195,7 @@ def handler(event, context):
                 self.log_metrics,
                 capture_cold_start_metric=capture_cold_start_metric,
                 raise_on_empty_metrics=raise_on_empty_metrics,
-                default_dimensions=default_dimensions,
+                **extra_args,
             )
 
         @functools.wraps(lambda_handler)

aws_lambda_powertools/metrics/provider/datadog/__init__.py

@@ -0,0 +1,7 @@
+from aws_lambda_powertools.metrics.provider.datadog.datadog import DatadogProvider
+from aws_lambda_powertools.metrics.provider.datadog.metrics import DatadogMetrics
+
+__all__ = [
+    "DatadogMetrics",
+    "DatadogProvider",
+]