Skip to content

Forwarding application that forwards requests from Prometheus alertmanager into Microsoft Teams

Notifications You must be signed in to change notification settings

marcel-dempers/kube-prometheus-msteams-alert

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kube-prometheus-msteams-alert

Forwarding application that forwards requests from Prometheus alertmanager into Microsoft Teams

Use Case

  • You are running a Kubernetes cluster
  • You monitor your environment using Prometheus
  • You have Prometheus Alert Manager running in your cluster and configured to generate alerts
  • You would like to have alerts sent to Microsoft Teams

What does it do ?

This app runs inside Kubernetes and listens on a port for Prometheus Alertmanager messages.
When alert comes in, the application will parse the alert and send it on the the configured receiver

It translates alert manager messages into JSON format that MS Teams will understand

Usage

Build it!

Build the docker image and push it to your registry!

cd src
docker build . -t alertmanager-msteams

docker push alertmanager-msteams

Edit your values !

Go to the values file at the root of this repo and fill out your values. Key values are:

  • image : Your docker image and registry
  • Your MS Teams webhook URL under configmap section

Deploy it !

Check your kubectl is configured to point to your cluster
Deploy using helm

helm install alertmanager-msteams -f values.yaml

Test

Simply POST json data to the /alert endpoint of this application. The json format needs to represent Prometheus structure described here

Your Prometheus Alertmanager needs to be configured to push alerts to external web hook:

<webhook_config>
The webhook receiver allows configuring a generic receiver.

Configuring your Prometheus Alert Manager to push to this endpoint will allow this app to forward convert the alert manager json into MS teams friendly JSON and pass it onto MS Teams webhook endpoint

About

Forwarding application that forwards requests from Prometheus alertmanager into Microsoft Teams

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages