xmpp-webhook

xmpp-webhook

• Multipurpose XMPP-Webhook (Built for DevOps Alerts)
• Based on https://github.com/mellium/xmpp

Status

xmpp-webhook currently support:

• Grafana Webhook alerts
• Slack Incoming Webhooks (Feedback appreciated)

Check https://github.com/opthomas-prime/xmpp-webhook/blob/master/parser/ 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_PASS - The password
  • XMPP_RECEIVERS - Comma-seperated list of JID's
  • XMPP_SKIP_VERIFY - Skip TLS verification (Optional)
  • XMPP_OVER_TLS - Use dedicated TLS port (Optional)
• After startup, xmpp-webhook tries to connect to the XMPP server and provides the implemented HTTP enpoints (on :4321). e.g.:

curl -X POST -d @grafana-webhook-alert-example.json localhost:4321/grafana
curl -X POST -d @slack-compatible-notification-example.json localhost:4321/slack

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

Run with Docker

Build it

• Build image: docker build -t xmpp-webhook .
• Run: docker run -e "XMPP_ID=alerts@example.org" -e "XMPP_PASS=xxx" -e "XMPP_RECEIVERS=receiver1@example.org,receiver2@example.org" -p 4321:4321 -d --name xmpp-webhook xmpp-webhook

Use prebuilt image from Docker Hub

• Run: docker run -e "XMPP_ID=alerts@example.org" -e "XMPP_PASS=xxx" -e "XMPP_RECEIVERS=receiver1@example.org,receiver2@example.org" -p 4321:4321 -d --name xmpp-webhook opthomasprime/xmpp-webhook:latest

Installation

IMPORTANT NOTE: For the sake of simplicity, xmpp-webhook is not reconnecting to the XMPP server after a connection-loss. If you use the provided xmpp-webhook.service - Systemd will manage the reconnect by restarting the service..

-> https://github.com/mellium/xmpp automatically reconnects after a failure.

• Download and extract the latest tarball (GitHub release page)
• Install the binary: install -D -m 744 xmpp-webhook /usr/local/bin/xmpp-webhook
• Install the service: install -D -m 644 xmpp-webhook.service /etc/systemd/system/xmpp-webhook.service
• Configure XMPP credentials in /etc/xmpp-webhook.env. e.g.:

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

• Enable and start the service:

systemctl daemon-reload
systemctl enable xmpp-webhook
systemctl start xmpp-webhook

Building

• Dependencies are managed via Go Modules (https://github.com/golang/go/wiki/Modules).
• Clone the sources
• Change in the project folder:
• Build xmpp-webhook: go build

Need help?

Feel free to contact me!