Many clients have asked me “how do I record custom metrics from Lambda?”.
Generally speaking, you can either:
- Publish custom metrics synchronously – e.g. send them at the end of an invocation.
- Publish custom metrics asynchronously by writing them to stdout first and then extracting them from CloudWatch Logs.
Problems with sending custom metrics synchronously
The synchronous approach adds latency to invocations. This can be especially problematic when those extra milliseconds are experienced by our users. For example, if the user is waiting for an API response.
Individually, the delay might be negligible. CloudWatch metrics typically respond within tens of milliseconds. That is acceptable to most. But they can quickly compound when functions call one another via API Gateway.
Moreover, services are most fragile around their integration points – i.e. when they make network calls to other services. Publishing metrics to CloudWatch introduces another integration point that you need to harden.
If CloudWatch experiences an outage, surely you would still want your system to stay up, right? Similarly, if CloudWatch experiences elevated response time then you wouldn’t want your functions to timeout as a result!
Hence why I generally prefer to record custom metrics asynchronously, even though this approach also has its drawbacks:
- There is an additional delay in seeing the most recent metric data.
- It’s sending more data to CloudWatch Logs, which has a cost implication
- It introduces complexity because you need something to process the logs and turn them into metrics.
Sending custom metrics asynchronously
In simple cases, where you have few custom metrics, CloudWatch metric filters are the way to go. However, this approach does not scale with complexity – when you have lots of functions and custom metrics.
Instead, you can use a Lambda function.
To make it really easy for you to record custom metrics asynchronously, I have published a new application to the Serverless Application Repository. You can also check out the source code on GitHub here.
You can deploy the app via the AWS console here, by clicking the
Deploy button and follow the instructions.
Or you can deploy it as part of a CloudFormation stack with AWS SAM:
You can do the same via CloudFormation or the Serverless framework. You need to first add the following
Transform though. For more details on how to do this with the Serverless framework, read this post.
We announced this new app live on Twitch yesterday. You can go to the 21:00 mark and see how you can configure everything via CloudFormation, including subscribing all CloudWatch log groups to a Kinesis stream first, before subscribing this app to that stream.
Recording custom metrics
Once deployed, you would be able to record custom metrics by writing to
stdout in this format:
unitcan be any of the allowed CloudWatch metric units
namespace: custom metrics would appear under this namespace, e.g.
dimensions: comma-separated key-value pairs, e.g.
These messages would be processed and published as custom metrics in CloudWatch metrics. All without adding latency to your invocations!
I hope you enjoy this new app, and please feel free to suggest improvements via GitHub issues. Here are some ideas I have for making it more useful:
- Parse the
REPORTmessages at the end of an invocation and turn
Memory Usedinto metrics:
- Since AppSync doesn’t report resolver metrics to CloudWatch, we can parse the resolver logs and report resolver duration as metrics.
Enjoy what you’re reading? Subscribe to my newsletter and get more content on AWS and serverless technologies delivered straight to your inbox.
I’m an AWS Serverless Hero and the author of Production-Ready Serverless. I have run production workload at scale in AWS for nearly 10 years and I have been an architect or principal engineer with a variety of industries ranging from banking, e-commerce, sports streaming to mobile gaming. I currently work as an independent consultant focused on AWS and serverless.
In this course, we’ll cover everything you need to know to use AWS Step Functions service effectively. Including basic concepts, HTTP and event triggers, activities, design patterns and best practices.
Come learn about operational BEST PRACTICES for AWS Lambda: CI/CD, testing & debugging functions locally, logging, monitoring, distributed tracing, canary deployments, config management, authentication & authorization, VPC, security, error handling, and more.
You can also get 40% off the face price with the code ytcui.
Here is a complete list of all my posts on serverless and AWS Lambda. In the meantime, here are a few of my most popular blog posts.
- Lambda optimization tip – enable HTTP keep-alive
- You are thinking about serverless costs all wrong
- Many faced threats to Serverless security
- We can do better than percentile latencies
- I’m afraid you’re thinking about AWS Lambda cold starts all wrong
- Yubl’s road to Serverless
- AWS Lambda – should you have few monolithic functions or many single-purposed functions?
- AWS Lambda – compare coldstart time with different languages, memory and code sizes
- Guys, we’re doing pagination wrong