Lambda extension

Created:
July 15, 2024
Updated:
May 23, 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:

  1. Building the extension binary using Go.
  2. Packaging it into a Lambda Layer.
  3. Publishing it to AWS Lambda, either privately or publicly.