Skip to content
Plugin that receives SNS notification from Alerts created by AWS CloudWatch and sent via AWS SNS
Go Makefile
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Use Go modules for coverage CI job (#26) Aug 30, 2019
build fix May 28, 2019
server Use Go modules for coverage CI job (#26) Aug 30, 2019
.editorconfig fix May 28, 2019
.gitignore initial commit Feb 25, 2019
LICENSE initial commit Feb 25, 2019
Makefile
README.md
go.mod Update mattermost-server from 5.11.0 to 5.14.1 (#27) Sep 25, 2019
go.sum Update mattermost-server from 5.11.0 to 5.14.1 (#27) Sep 25, 2019
plugin.json Bump version (#24) Jul 17, 2019

README.md

AWS SNS Plugin CircleCI

Send alert notifications from Amazon AWS CloudWatch to Mattermost channels via AWS SNS.

Originally developed by Carlos Tadeu Panato Junior.

image

Configuration

Step 1: Configure plugin in Mattermost

  1. Go to System Console > Plugins > AWS SNS:

  2. Set the channel to send notifications to, specified in the format teamname,channelname. If the specified channel does not exist, the plugin will create the channel for you.

  3. Set authorized users who can accept AWS SNS subscriptions. Must be a comma-separated list of user ID's.

  4. Set the username that this integration is attached to.

  5. Generate a token used for an AWS SNS subscription. Copy this value as you will use it in a later step.

  6. Go to System Console > Plugins > Management and click Enable to enable the AWS SNS plugin.

Note: If you are running Mattermost v5.11 or earlier, you must first go to the releases page of this GitHub repository, download the latest release, and upload it to your Mattermost instance following this documentation.

Step 2: Configure plugin in Amazon AWS

  1. Create an AWS CloudWatch alarm for your instance.

  2. Create an AWS SNS Topic with an HTTPS subscription to https://your-mattermost-url/plugins/com.mattermost.aws-sns?token=your-mattermost-token`, where your-mattermost-url refers to your Mattermost URL, and your-mattermost-token was generated on a previous step. Follow this documentation for additional configuration options.

  3. Switch to the Mattermost channel you configured to receive notifications. Accept the subscription posted to the channel by clicking the "Confirm" button.

  4. Configure your AWS CloudWatch Alarms to use the topic you created previously.

You're all set! Alerts should now get posted from AWS CloudWatch to Mattermost.

Development

This plugin contains a server portion.

Use make dist to build distributions of the plugin that you can upload to a Mattermost server. Use make check-style to check the style. Use make deploy to deploy the plugin to your local server.

For additional information on developing plugins, refer to our plugin developer documentation.

You can’t perform that action at this time.