https://github.com/cplankey/lambda-errors-to-slack

Subscribes to tagged Lambdas in your account and forwards their errors to a specified Slack channel
https://github.com/cplankey/lambda-errors-to-slack

Last synced: about 2 months ago
JSON representation

Subscribes to tagged Lambdas in your account and forwards their errors to a specified Slack channel

• Host: GitHub
• URL: https://github.com/cplankey/lambda-errors-to-slack
• Owner: cplankey
• Created: 2020-09-06T13:51:35.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2020-09-06T16:19:04.000Z (about 4 years ago)
• Last Synced: 2024-05-28T13:29:43.924Z (4 months ago)
• Language: JavaScript
• Size: 111 KB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Lambda Monitoring to Slack Stack

This stack is designed to allow you to monitor your AWS Lambda errors and send alerts to a specified slack channel. There are plenty of paid services (and even some free ones) that offer the same functionality, but the largest drawback is that it requires you to send your logs to a vendor's AWS account. This solution allows you to keep the logs in your account and customize which Lambda's forward their logs to slack.

## Error Types

The current implementation picks up and Lambda Error, Timeout, and any message written with `console.error()`.

## Resources

### Subscriber

The subscriber lambda is invoked any time you update tags on a Lambda function. The subscriber looks for a tag named `monitoring` and looks for that tag value to evaluate to `true`. If the subscriber finds the `monitoring` tag is set to `true` then it creates a new log subscription on the updated lambda. This log subscription subscribes the `Alerter` lambda to the modified lambda's log group.

![Monitoring Tag](img/tags.png)

If the monitoring tag does not exist or is set to false, this Lambda will check if the `Alerter` function is subscribed to the log groups and remove the subscription if so. This allows you to toggle on and off the subscriptions as needed.

### Alerter

This lambda is invoked by Cloudwatch Logs when a lambda with the `monitoring` tag writes logs. This lambda then parses the log event to find out if it is a function error or a `console.error()`. It then relays this information to a specified slack channel.

## Configuring Slack Settings

At this time, this app requires you to specify a Slack Webhook URL. To generate a Slack Webhook URL, follow the `Create The Slack App` portion of [this Medium post](https://medium.com/@cplankey/use-lambda-layers-to-post-to-slack-513782db3d82). Once you have a Webhook URL, you need to add it to the `serverless.yml` file in the `alerter` function's `environment` settings. If your Slack Webhook URL looks like this:

    `https://hooks.slack.com/services/ABCDEF123/12345ABCDEF/XXXXYYYYXXXXYYYYXXXXYYYY`

then update the environment variable to look like this:

    alerter:

	    handler: alerter/index.main

	    environment:

		    SLACK_WEBHOOK_URL: ABCDEF123/12345ABCDEF/XXXXYYYYXXXXYYYYXXXXYYYY