Example of multiple dimension data #338

Activity

1. btorretta

   added

   documentationImprovements or additions to documentationImprovements or additions to documentation

   on Mar 13, 2021
2. heitorlessa commented on Mar 15, 2021

   

   heitorlessa

   on Mar 15, 2021

   Contributor

   More actions

   Hi @btorretta, thanks for raising it so we can improve our docs. Could you give me a concrete example of what you're trying to achieve?

   If I understood what you're after correctly, that visual can be represented in the following code. This demonstrates that every function function emit distinct metrics to the same namespace allowing them to group all metrics to a given application composed of multiple services. They use a different service name to easily filter metrics out, so you'd know metric X was emitted by service Y.

   shoppingcart-service Lambda function

   from aws_lambda_powertools import Metrics
   from aws_lambda_powertools.metrics import MetricUnit
   
   metrics = Metrics(namespace="e-commerce-app", service="shoppingcart-service")
   
   metrics.add_metric(name="CartUpdated", unit=MetricUnit.Count, value=10)
   metrics.add_metric(name="CartCheckedOut", unit=MetricUnit.Count, value=1)

   product-service Lambda function

   from aws_lambda_powertools import Metrics
   from aws_lambda_powertools.metrics import MetricUnit
   
   metrics = Metrics(namespace="e-commerce-app", service="product-service")
   
   metrics.add_metric(name="ProductAdded", unit=MetricUnit.Count, value=5)
   metrics.add_metric(name="ProductRemoved", unit=MetricUnit.Count, value=1)

   delivery-service Lambda function

   from aws_lambda_powertools import Metrics
   from aws_lambda_powertools.metrics import MetricUnit
   
   metrics = Metrics(namespace="e-commerce-app", service="delivery-service")
   
   metrics.add_metric(name="DeliverySuccess", unit=MetricUnit.Count, value=10)
   metrics.add_metric(name="DeliveryTime", unit=MetricUnit.Seconds, value=60)

   In this example, we add multiple values to the metric ProductAdded, first 5, then 10. While you can add multiple values to a given metric, you cannot have a dimension with multiple values.

   product-service Lambda function with multiple values

   from aws_lambda_powertools import Metrics
   from aws_lambda_powertools.metrics import MetricUnit
   
   metrics = Metrics(namespace="e-commerce-app", service="product-service")
   
   metrics.add_metric(name="ProductAdded", unit=MetricUnit.Count, value=5)
   # Additional value to the same metric
   metrics.add_metric(name="ProductAdded", unit=MetricUnit.Count, value=10)

   👍React with 👍1Reacted by Michael Brewer
3. heitorlessa

   added

   need-more-informationPending information to continuePending information to continue

   on Mar 17, 2021
4. heitorlessa

   closed this as completedon Mar 19, 2021
5. aws-powertools

   locked and limited conversation to collaborators on Mar 19, 2021
6. dreamorosi

   added this to Powertools for AWS Lambda (Python)on Jan 22, 2025
7. github-project-automation

   moved this to Triage in Powertools for AWS Lambda (Python)on Jan 22, 2025