monitoring-functions-access-metrics.md

Monitoring functions in the AWS Lambda console

AWS Lambda monitors functions on your behalf and sends metrics to Amazon CloudWatch. The Lambda console creates monitoring graphs for these metrics and shows them on the Monitoring page for each Lambda function.

This page describes the basics of using the Lambda console to view function metrics, including total requests, duration, and error rates.

Pricing

CloudWatch has a perpetual free tier. Beyond the free tier threshold, CloudWatch charges for metrics, dashboards, alarms, logs, and insights. For more information, see Amazon CloudWatch pricing.

Using the Lambda console

You can use the Lambda console's monitoring dashboard to monitor your Lambda functions and applications.

To monitor a function

1. Open the Functions page on the Lambda console.

2. Choose a function.

3. Choose Monitoring.

Types of monitoring graphs

The following section describes the monitoring graphs on the Lambda console.

Lambda monitoring graphs

• Invocations – The number of times that the function was invoked.
• Duration – The average, minimum, and maximum execution times.
• Error count and success rate (%) – The number of errors and the percentage of executions that completed without error.
• Throttles – The number of times that execution failed due to concurrency limits.
• IteratorAge – For stream event sources, the age of the last item in the batch when Lambda received it and invoked the function.
• Async delivery failures – The number of errors that occurred when Lambda attempted to write to a destination or dead-letter queue.
• Concurrent executions – The number of function instances that are processing events.

Viewing graphs on the Lambda console

The following section describes how to view CloudWatch monitoring graphs on the Lambda console, and open the CloudWatch metrics dashboard.

To view monitoring graphs for a function

1. Open the Functions page on the Lambda console.

2. Choose a function.

3. Choose Monitoring.

4. Choose from the predefined time ranges, or choose a custom time range.

5. To see the definition of a graph in CloudWatch, choose the three vertical dots, and then choose View in metrics to open the Metrics dashboard in CloudWatch.

Viewing queries in the CloudWatch Logs console

The following section describes how to view and add reports from CloudWatch Logs Insights to a custom dashboard on the CloudWatch Logs console.

To view reports for a function

1. Open the Functions page on the Lambda console.

2. Choose a function.

3. Choose Monitoring.

4. Choose View logs in CloudWatch.

5. Choose View in Logs Insights.

6. Choose from the predefined time ranges, or choose a custom time range.

7. Choose Run query.

8. (Optional) Choose Save.

What's next?

• Learn about the metrics that Lambda records and sends to CloudWatch in Working with AWS Lambda function metrics.
• Learn how to use Lambda Insights to collect and aggregate Lambda function runtime performance metrics and logs in Using Lambda Insights in Amazon CloudWatch.