Multipurpose XMPP-Webhook : Grafana Webhook alerts Alertmanager Webhooks Slack Incoming Webhooks

alerting grafana notifications prometheus slack xmpp

Go to file

Thomas Maier bff7a15fdb README WiP		2017-09-26 16:21:12 +02:00
.gitignore	README wiP	2017-09-26 16:11:33 +02:00
Gopkg.toml	adds vendoring	2017-09-26 15:34:48 +02:00
LICENSE	Initial commit	2017-09-24 13:57:48 +02:00
README.md	README WiP	2017-09-26 16:21:12 +02:00
THIRD-PARTY-NOTICES	Create THIRD-PARTY-NOTICES	2017-09-26 15:47:28 +02:00
handler.go	new grafana alert formatting	2017-09-26 15:03:46 +02:00
main.go	refactoring	2017-09-26 14:39:19 +02:00
xmpp-webhook.service	adds systemd service file	2017-09-26 15:10:33 +02:00

README.md

xmpp-webhook

Multipurpose XMPP-Webhook (Built for Prometheus/Grafana Alerts)
Based on https://github.com/atomatt/go-xmpp

Status

xmpp-webhook currently only provides a hook for Grafana. I will implement a parserFunc for Prometheus ASAP. Check https://github.com/opthomas-prime/xmpp-webhook/blob/master/handler.go to learn how to support more source services.

Usage

xmpp-webhook is configured via environment variables:
- XMPP_ID - The JID we want to use
- XMPP_PAS - The password
- XMPP_RECEIVERS - Comma-seperated list of JID's
After startup xmpp-webhooks tries to connect to the XMPP server and provides the implemented HTTP enpoints (on :4321). e.g.:

curl -X POST -d @grafana-alert.json localhost:4321

After parsing the body in the appropriate parserFunc, the notification is then distributed to the configured receivers.

XMPP_ID='bot@example.com'
XMPP_PASS='passw0rd'
XMPP_RECEIVERS='jdoe@example.com,ops@example.com'

/etc/systemd/system/xmpp-webhook.service

https://github.com/golang/dep
go get -u github.com/golang/dep/cmd/dep