Create a Lambda notification integration

Created:
April 26, 2023
Updated:
September 18, 2024

The AWS Lambda Integration enables FireTail to automatically trigger AWS Lambda functions in response to alerts or incidents. When an alert is triggered, FireTail sends a notification payload to a specified Lambda function, which you can customize. The integration can be quickly set up using CloudFormation templates or configured manually.

1. Navigate to Integrations in the FireTail platform.

2. Click Lambda Function.

3. In the Name of Integration field, enter a name for the integration.

4. Choose the deployment method, you can either:

  • Use a Launch CloudFormation template - this is a template that adds the required IAM role to the account.
  • ‍Manually deploy. To do this, click Manual setup of IAM Role and follow the on screen instructions.

5. When using the template, select the Launch IAM role CloudFormation template heading.

6. Log in to AWS. Then return to the FireTail platform. 

7. Click Launch CloudFormation to launch the template. This opens in a new window.

8. Copy the value in the LambdaFunctionARN field.

9. Return to the FireTail platform. Paste the copied value in the AWS Function ARN field. Note: the existing value in this field is a placeholder and should be replaced with the generated value.

10. Return to the CloudFormation template in AWS. Select the checkbox; I acknowledge that AWS CloudFormation might create IAM resources. Click Create stack.

11. When the CloudFormation Stack has a status of CREATE_COMPLETE, go to the Outputs tab and copy the FireTailRoleARN value.

12. Return to the FireTail platform. Paste the copied value in the AWS role ARN field.

13. (Optional) Edit the Lambda payload if required. This is the information that is populated in the Lambda notification when an alert or incident is triggered. Tokens, which are placeholders embedded in the payload, dynamically insert relevant data such as alert details, timestamps and so on. You can edit these tokens to customize the information displayed in the notification. For a full list of tokens, go to Dynamic variables. Learn how to Customize notifications.

14. Click Submit.

Your Lambda integration will now appear under the "Existing Integrations" tab. You can select it as the notification method when you create an alert or create an incident.