https://github.com/rewindio/aws-cloudwatch-slack-notifier

Lambda to send notifications to Slack for Cloudwatch alarms
https://github.com/rewindio/aws-cloudwatch-slack-notifier

cloudwatch-alarms lama lambda slack

Last synced: 3 months ago
JSON representation

Lambda to send notifications to Slack for Cloudwatch alarms

• Host: GitHub
• URL: https://github.com/rewindio/aws-cloudwatch-slack-notifier
• Owner: rewindio
• License: mit
• Archived: true
• Created: 2018-12-20T16:35:06.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2020-07-24T12:43:29.000Z (over 4 years ago)
• Last Synced: 2024-06-28T08:32:31.980Z (5 months ago)
• Topics: cloudwatch-alarms, lama, lambda, slack
• Language: Python
• Size: 58.6 KB
• Stars: 6
• Watchers: 5
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# aws-cloudwatch-slack-notifier

Make Cloudwatch alarms readable in Slack

![Alama](https://raw.githubusercontent.com/rewindio/aws-cloudwatch-slack-notifier/main/images/lama-emoji.png)

The AWS Cloudwatch Slack Notifier (or Alama, Alamer) formats Cloudwatch alarms to be a little easier to read.

# Installing and Configuring

## Slack Setup

Before installing anything to AWS, you will need to configure an incoming webhook in Slack to handle the posts for you.  Slack has lots of docs on this.  Once you have the Slack webhook URL, grab it as you'll need it next.

Within the images folder of this repo is a lama emoji. This needs to be added to Slack as a custom emoji and named `:lama:`

## AWS Setup

* Take the Slack webhook URL and save it as an encrypted parameter in AWS Parameter store.

* Get the Key ID from KMS which is used to encrypt your parameter store secret

## Deploying to AWS

Before starting, you will need:

* The [AWS CLI](https://aws.amazon.com/cli/) installed and default credentials configured

* the [AWS SAM CLI](https://github.com/awslabs/aws-sam-cli) installed

* An existing S3 bucket where the AWS Lambda code will be deployed to by SAM

* This repo cloned

1. Run the *build.sh* script.  This will just copy the needed files into the right locations

2. Run the *deploy.sh* script like

```

./deploy.sh     '' '

```

For Example:

```

./deploy.sh staging us-east-1 lambda-sam-staging '#alarms' '/devops/slack/incoming-webhook' 123456-1224-1234-5678-987654321

```

deploy.sh uses AWS SAM to package the AWS Lambda functions and then deploys them to AWS.  Everything is deployed as a Cloudformation Stack in the specified region.

## Cloudwatch Alarm Configuration

The template creates an SNS topic called `cloudwatch_to_slack` and subscribes the Lambda to it.  Any Cloudwatch alarms you want formatted and sent to the configured Slack channel should just be configured to notify this topic.  The Lambda will do the rest.