monitoring-functions-access-metrics.md

Monitoring functions on the Lambda console

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 monitor your Lambda functions and applications on the Lambda console.

To monitor a function

1. Open the Functions page of the Lambda console.

2. Choose a function.

3. Choose the Monitor tab.

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 amount of time your function code spends processing an event.
• Error count and success rate (%) – The number of errors and the percentage of invocations that completed without error.
• Throttles – The number of times that an invocation 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 of the Lambda console.

2. Choose a function.

3. Choose the Monitor tab.

4. On the Metrics, Logs, or Traces tab, 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 (Widget actions), and then choose View in metrics to open the Metrics dashboard on the CloudWatch console.

Viewing queries on 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 of the Lambda console.

2. Choose a function.

3. Choose the Monitor tab.

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 Lambda function metrics.
• Learn how to use CloudWatch Lambda Insights to collect and aggregate Lambda function runtime performance metrics and logs in Using Lambda Insights in Amazon CloudWatch.