Monitoring AWS Lambda Python Functions

To add the layers to your Lambda function through the AWS Management Console:

1. Navigate to your function in the AWS Management Console

2. Scroll to the Layers section and click the Add a layer button

3. Choose the Specify an ARN radio button

4. Copy and paste the following ARNs of the Elastic APM AWS Lambda extension layer and the APM agent layer in the Specify an ARN text input:

   • APM Extension layer:

     arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-extension-ver-1-5-7-{ARCHITECTURE}:1 1
     

     1. Replace {AWS_REGION} with the AWS region of your Lambda function and {ARCHITECTURE} with its architecture.

   • APM agent layer:

     arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-python-ver-6-23-0:1 1
     

     1. Replace {AWS_REGION} with the AWS region of your Lambda function.

   

5. Click the Add button

To add the Layer ARNs of the Elastic APM AWS Lambda extension and the APM agent through the AWS command line interface execute the following command:

aws lambda update-function-configuration --function-name yourLambdaFunctionName \
--layers arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-extension-ver-1-5-7-{ARCHITECTURE}:1 \ 1
arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-python-ver-6-23-0:1 2

1. Replace {AWS_REGION} with the AWS region of your Lambda function and {ARCHITECTURE} with its architecture.
2. Replace {AWS_REGION} with the AWS region of your Lambda function.

In your SAM template.yml file add the Layer ARNs of the Elastic APM AWS Lambda extension and the APM agent as follows:

...
Resources:
  yourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      ...
      Layers:
          - arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-extension-ver-1-5-7-{ARCHITECTURE}:1 1
          - arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-python-ver-6-23-0:1 2
...

1. Replace {AWS_REGION} with the AWS region of your Lambda function and {ARCHITECTURE} with its architecture.
2. Replace {AWS_REGION} with the AWS region of your Lambda function.

In your serverless.yml file add the Layer ARNs of the Elastic APM AWS Lambda extension and the APM agent to your function as follows:

...
functions:
  yourLambdaFunction:
    handler: ...
    layers:
      - arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-extension-ver-1-5-7-{ARCHITECTURE}:1 1
      - arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-python-ver-6-23-0:1 2
...

1. Replace {AWS_REGION} with the AWS region of your Lambda function and {ARCHITECTURE} with its architecture.
2. Replace {AWS_REGION} with the AWS region of your Lambda function.

To add theElastic APM AWS Lambda extension and the APM agent to your function add the ARNs to the layers property in your Terraform file:

...
resource "aws_lambda_function" "your_lambda_function" {
  ...
  layers = ["arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-extension-ver-1-5-7-{ARCHITECTURE}:1", "arn:aws:lambda:{AWS_REGION}:267093732750:layer:elastic-apm-python-ver-6-23-0:1"] 1
}
...

1. Replace {AWS_REGION} with the AWS region of your Lambda function and {ARCHITECTURE} with its architecture.

To add the Elastic APM AWS Lambda extension and the APM agent to your container-based function extend the Dockerfile of your function image as follows:

FROM docker.elastic.co/observability/apm-lambda-extension-{IMAGE_ARCH}:latest AS lambda-extension 1
FROM docker.elastic.co/observability/apm-agent-python:latest AS python-agent

# FROM ...  <-- this is the base image of your Lambda function

COPY --from=lambda-extension /opt/elastic-apm-extension /opt/extensions/elastic-apm-extension
COPY --from=python-agent /opt/python/ /opt/python/

# ...

1. Replace {IMAGE_ARCH} with the architecture of the image.

To configure APM through the AWS Management Console:

1. Navigate to your function in the AWS Management Console
2. Click on the Configuration tab
3. Click on Environment variables
4. Add the following required variables:

AWS_LAMBDA_EXEC_WRAPPER       = /opt/python/bin/elasticapm-lambda  1
ELASTIC_APM_LAMBDA_APM_SERVER = <YOUR-APM-SERVER-URL>              2
ELASTIC_APM_SECRET_TOKEN      = <YOUR-APM-SECRET-TOKEN>            3
ELASTIC_APM_SEND_STRATEGY     = background                         4

1. Use this exact fixed value.
2. This is your APM Server URL.
3. This is your APM secret token.
4. The ELASTIC_APM_SEND_STRATEGY defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.

To configure APM through the AWS command line interface execute the following command:

aws lambda update-function-configuration --function-name yourLambdaFunctionName \
    --environment "Variables={AWS_LAMBDA_EXEC_WRAPPER=/opt/python/bin/elasticapm-lambda,ELASTIC_APM_LAMBDA_APM_SERVER=<YOUR-APM-SERVER-URL>,ELASTIC_APM_SECRET_TOKEN=<YOUR-APM-SECRET-TOKEN>,ELASTIC_APM_SEND_STRATEGY=background}"

In your SAM template.yml file configure the following environment variables:

...
Resources:
  yourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      ...
      Environment:
          Variables:
            AWS_LAMBDA_EXEC_WRAPPER: /opt/python/bin/elasticapm-lambda
            ELASTIC_APM_LAMBDA_APM_SERVER: <YOUR-APM-SERVER-URL>
            ELASTIC_APM_SECRET_TOKEN: <YOUR-APM-SECRET-TOKEN>
            ELASTIC_APM_SEND_STRATEGY: background 1
...

1. The ELASTIC_APM_SEND_STRATEGY defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.

In your serverless.yml file configure the following environment variables:

...
functions:
  yourLambdaFunction:
    ...
    environment:
      AWS_LAMBDA_EXEC_WRAPPER: /opt/python/bin/elasticapm-lambda
      ELASTIC_APM_LAMBDA_APM_SERVER: <YOUR-APM-SERVER-URL>
      ELASTIC_APM_SECRET_TOKEN: <YOUR-APM-SECRET-TOKEN>
      ELASTIC_APM_SEND_STRATEGY: background 1
...

1. The ELASTIC_APM_SEND_STRATEGY defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.

In your Terraform file configure the following environment variables:

...
resource "aws_lambda_function" "your_lambda_function" {
  ...
  environment {
    variables = {
      AWS_LAMBDA_EXEC_WRAPPER       = /opt/python/bin/elasticapm-lambda
      ELASTIC_APM_LAMBDA_APM_SERVER = "<YOUR-APM-SERVER-URL>"
      ELASTIC_APM_SECRET_TOKEN      = "<YOUR-APM-SECRET-TOKEN>"
      ELASTIC_APM_SEND_STRATEGY     = "background" 1
    }
  }
}
...

1. The ELASTIC_APM_SEND_STRATEGY defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.

Environment variables configured for an AWS Lambda function are passed to the container running the lambda function. You can use one of the other options (through AWS Web Console, AWS CLI, etc.) to configure the following environment variables:

AWS_LAMBDA_EXEC_WRAPPER       = /opt/python/bin/elasticapm-lambda  1
ELASTIC_APM_LAMBDA_APM_SERVER = <YOUR-APM-SERVER-URL>              2
ELASTIC_APM_SECRET_TOKEN      = <YOUR-APM-SECRET-TOKEN>            3
ELASTIC_APM_SEND_STRATEGY     = background                         4

1. Use this exact fixed value.
2. This is your APM Server URL.
3. This is your APM secret token.
4. The ELASTIC_APM_SEND_STRATEGY defines when APM data is sent to your Elastic APM backend. To reduce the execution time of your lambda functions, we recommend to use the background strategy in production environments with steady load scenarios.