https://github.com/ashiina/aws-lambda-cloudwatch-slack

Amazon Lambda to receive data from CloudWatch and post to Slack
https://github.com/ashiina/aws-lambda-cloudwatch-slack

Last synced: 3 months ago
JSON representation

Amazon Lambda to receive data from CloudWatch and post to Slack

• Host: GitHub
• URL: https://github.com/ashiina/aws-lambda-cloudwatch-slack
• Owner: ashiina
• Created: 2015-06-08T22:48:35.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2017-04-26T13:05:09.000Z (over 7 years ago)
• Last Synced: 2024-05-28T14:23:57.155Z (6 months ago)
• Language: JavaScript
• Size: 4.88 KB
• Stars: 86
• Watchers: 7
• Forks: 35
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# lambda-cloudwatch-slack

Amazon Lambda to receive alerts from CloudWatch and post to Slack.

## What is This?

It's an Amazon lambda script that receives data from Amazon CloudWatch via, then posts that result over to Slack.

Just configure the javascript file and set it in Lambda, then you are good to go.

## How to Use

### Alarm configuration

In `handler.js`, you will find `ALARM_CONFIG`, which is the config for your alarms.

You can set different configs for different alarm conditions, depending on the

*subject of* the CloudWatch notification.

| name | description |

|:-----------|:------------|

| condition | The script will match the CloudWatch's subject for this value |

| channel | Which channel to post to |

| mention | any mentions you will want to direct it at |

| color | color of the sidebar when posted in slack |

| severity | Optional text indicating the severity, just displayed in the message |

### Slack configuration

In `handler.js`, you will find `SLACK_CONFIG`, which is the config for you Slack.

Set the correct values in this.

| name | description |

|:-----------|:------------|

| path | The path of your webhook URL. |

If you have trouble finding the above,

Go here to set up your *Incoming Webbhook* integration for Slack,

https://api.slack.com/incoming-webhooks

Then find your *Webhook URL*. The configs will be:

```

https://hooks.slack.com/{path}

```

### Amazon CloudWatch configuration

Set whatever CloudWatch you want in your CloudWatch settings.

Be sure to remember the SNS topic you send the alarms to.

### Amazon Lambda configuration

1. In the Lambda console panel, create a new Lambda function. Set the name to be whatever you want it to be.

2. For the code of the Lambda function, copy and paste the `handler.js` file.

3. After you have created the function, select *add event sources* for the Lambda function.

4. In the event sources, select *SNS* and select the topic for which you've created on CloudWatch.

That is all. You should be receiving CloudWatch alerts on your Slack.

## Testing, Debugging

When you want to debug/test your Lambda function, try using my `lambda-local` NPM.

It's a command-line tool that let's you execute Lambda functions on your local machine.

https://github.com/ashiina/lambda-local

## License

This library is released under the MIT license.