AWS Lambda

Lambda functions can be written in numerous programming languages (Javascript, Python, Ruby, Java, Go, ...). Sentry is currently supporting automatic instrumentation of Lambda functions written in Javascript and Python.

See the Sentry Documentation on how to set up serverless instrumentation.

A Lambda function is a zipped directory that contains everything the Lambda language runtime needs to execute the code in it. You need to have your function code as well as all dependencies in your Lambda function directory. Lambda functions are invoked by an event (ex: visiting an URL) and are billed by the milliseconds the function took to complete.

AWS Lambda Function Lifecycle

AWS Lambda layers can be attached to functions. Layers are zipped directories as well and contain additional code used by your Lambda function. Layers are used for sharing code between functions or to add third-party functionality, like the Sentry SDK to your Lambda function.

With the AWS Lambda Integrations users can add Sentry functionality to their Lambda function without changing the code of the Lambda function.

Sentry is providing a Lambda Layer including the Javascript SDK (or Python SDK).

See the documentation to learn how customers can instrument their Lambda functions: https://docs.sentry.io/product/integrations/cloud-monitoring/aws-lambda/

Sentry is deploying one Lambda Layer for Node-based Lambda functions (SentryNodeServerlessSDK) and one Lambda Layer for Python-based Lambda functions (SentryPythonServerlessSDK). Those Lambda layers are distributed to various AWS regions to be close to the users.

Both these layers include the latest Sentry Javascript SDK (or Python SDK).

The contents of the Layer directory for the Python layer are built during the "CI" workflow in Github actions. The steps necessary can be found here.

This will prepare the Lambda layer directory, compress everything and upload the resulting zip file as an artifact to GitHub.

The zip file prepared in the previous step will be deployed to AWS Lambda by Craft.The configuration of craft for doing this can be found here.

To deploy a new version of the Lambda layer to AWS, you need to trigger a new release of the Python SDK.

The contents of the Layer directory for the Javascript/Node layer are built during the "Build & Test" workflow in Github actions. The steps necessary can be found here.

This will prepare the Lambda layer directory, compress everything and upload the resulting zip file as an artifact to GitHub.

The zip file prepared in the previous step will be deployed to AWS Lambda by Craft. The configuration of craft for doing this can be found here.

To deploy a new version of the Lambda layer to AWS, you need to trigger a new release of the Javascript SDK.

Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").