Integrations
Lambda extension
Updated: June 19, 2025
The FireTail Logging Extension collects AWS Lambda events and response payloads by proxying the Lambda runtime API and sends them to the FireTail Logging API.
Add the FireTail Lambda Layer
To use the FireTail Lambda Extension, you need to add the appropriate Lambda Layer to your function. You can either use the public Lambda Layer published by FireTail or build and publish your own.
Deriving the Latest Version
To find the latest public version, check the FireTail GitHub Releases. Replace any .
characters with -
in the version tag (e.g., v1.2.3
becomes v1-2-3
). Based on this, you can then substitute the version into the following ARN string for your Lambda's architecture:
For x86_64:
arn:aws:lambda:us-east-1:247286868737:layer:firetail-extension-x86_64-${VERSION}:1
For arm64:
arn:aws:lambda:us-east-1:247286868737:layer:firetail-extension-arm64-${VERSION}:1
Example:
- x86_64 -
arn:aws:lambda:us-east-1:247286868737:layer:firetail-extension-x86_64-v1-2-2:1
- arm64 -
arn:aws:lambda:us-east-1:247286868737:layer:firetail-extension-arm64-v1-2-2:1
To use this layer, you can add it through the AWS Console, AWS CLI, or infrastructure tools like Terraform.
Set the Required Environment Variables
Variable Name | Description | Default Value |
---|---|---|
AWS_LAMBDA_EXEC_WRAPPER | Must be set to /opt/firetail-wrapper.sh. |
None |
FIRETAIL_API_TOKEN | A FireTail API token. | None |
FIRETAIL_API_URL | The API URL for your FireTail SaaS instance. | https://api.logging.eu-west-1.prod.firetail.app/logs/bulk |
FireTail API tokens are created in the platform.
Build the Extension Yourself
If you prefer to build the FireTail Lambda Extension yourself instead of using the public Lambda Layer, you can follow the full build, package, and publish process detailed in the FireTail Lambda Extension GitHub Repository.
This involves:
- Building the extension binary using Go.
- Packaging it into a Lambda Layer.
- Publishing it to AWS Lambda, either privately or publicly.