AWS Lambda

Learn about other supported AWS services on our AWS docs.

Sensor (Data Collection)

Tracked Configuration

Lambda Function Details	Description
Name	The name of the function.
ARN	The unqualified Amazon Resource Name (ARN) assigned to the function.
Description	The user-provided description.
Runtime	The runtime environment for the Lambda function.
Handler	The function Lambda calls to begin executing your function.
Timeout	The function execution time at which Lambda should terminate the function.
Memory Size	The memory size, in MB, you configured for the function.
Last Modified	The time stamp of the last time you updated the function.
AWS Region	The location of function.

Metrics

Function Metrics	Description
Invocations	Measures the number of times a function is invoked in response to an event or invocation API call. This includes successful and failed invocations, but does not include throttled attempts. This equals the billed requests for the function.
Errors	Measures the number of invocations that failed due to errors in the function (response code 4XX). This includes: Handled exceptions (for example, context.fail(error)) Unhandled exceptions causing the code to exit Out of memory exceptions Timeouts Permissions errors This does not include invocations that fail due to invocation rates exceeding default concurrent limits (error code 429) or failures due to internal service errors (error code 500).
Dead Letter Errors	Incremented when Lambda is unable to write the failed event payload to your configured Dead Letter Queues. This could be due to the following: Permissions errors Throttles from downstream services Misconfigured resources Timeouts
Throttles	Measures the number of Lambda function invocation attempts that were throttled due to invocation rates exceeding the customer’s concurrent limits (error code 429).
Durations Average Minimum Maximum Sum	Measures the elapsed wall clock time from when the function code starts executing as a result of an invocation to when it stops executing. The maximum data point value possible is the function timeout configuration. The billed duration will be rounded up to the nearest 100 millisecond.
Iterator Age Average Minimum Maximum Sum	Emitted for stream-based invocations only (functions triggered by an Amazon DynamoDB stream or Kinesis stream). Measures the age of the last record for each batch of records processed. Age is the difference between the time Lambda received the batch, and the time the last record in the batch was written to the stream.

Global Metrics	Description
Concurrent Executions Average Minimum Maximum Sum	Emitted as an aggregate metric for all functions in the account, and for functions that have a custom concurrency limit specified. Measures the sum of concurrent executions for a given function at a given point in time.
Unreserved Concurrent Executions	Emitted as an aggregate metric for all functions in the account only. Represents the sum of the concurrency of the functions that do not have a custom concurrency limit specified.

Required Permissions

cloudwatch:GetMetricStatistics
cloudwatch:GetMetricData
lambda:ListTags
lambda:ListFunctions
lambda:GetFunctionConfiguration

Configuration

Metrics for Lambda are pulled every 5 minutes, this can be changed via agent configuration in <agent_install_dir>/etc/instana/configuration.yml:

com.instana.plugin.aws.lambda:
  cloudwatch_period: 300

To disable monitoring of Lambda instances use the following configuration:

com.instana.plugin.aws.lambda:
  enabled: false

Triggers

If a Lambda function is used as a trigger, all event source mappings will be displayed in the sidebar with links pointing to the attached AWS service. For more informations, see Invoking Lambda functions.