alertmanager-notifier

A notifier for alertmanager, written in python. It supports multiple notification channels and new ones can be easily added.

Deprecation

Telegram Deprecation: Starting with the version 0.5.0 of alertmanager-notifier, Telegram support is dropped. As such, the documentation has been updated to reflect it.

Running a simple test

docker run --rm -it \
    -p 8899:8899 \
    -e GOTIFY_URL="https://gotify" \
    -e GOTIFY_TOKEN="your gotify token" \
    -e EXCLUDE_LABELS="yes" \
    --name alertmanager-notifier \
    registry.gitlab.com/ix.ai/alertmanager-notifier:latest

Run the test agains the bot:

curl -X POST -d '{"externalURL": "http://foo.bar/", "receiver": "alertmanager-notifier-webhook", "alerts": [{"status":"Testing alertmanager-notifier", "labels":{}, "annotations":{}, "generatorURL": "http://foo.bar"}]}' -H "Content-Type: application/json" localhost:8899/alert

Configure alertmanager

route:
  receiver: 'alertmanager webhook'
  routes:
    - receiver: 'alertmanager-notifier-webhook'

receivers:
  - name: 'alertmanager-notifier-webhook'
    webhook_configs:
      - url: http://alertmanager-notifier:8899/alert

Supported environment variables

NOTE: If no notifier is configured, the Null notifier will be used and the notification will only be logged

Gotify Priority

Gotify supports message priorities, that are also mapped to Android Importance (see gotify/android#18).

If you set the annotation priority to your alert, with a number as value, this will be passed through to gotify.

Note: Since alertmanager supports sending multiple alerts in one message, alertmanager-notifier will always use the highest priority value for gotify from the batch.

Templating

alertmanager-notifier supports jinja templating. take a look in the templates/ folder for examples for that. If you want to use your own template, mount it as a volume in docker and set the *_TEMPLATE environment variable. The mount path should be under /templates/ (for example /templates/my-amazing-template).

Tags and Arch

The images are multi-arch, with builds for amd64, arm64, armv7 and armv6.

• vN.N.N - for example v0.0.1
• latest - always pointing to the latest version
• dev-master - the last build on the master branch

Images

• Gitlab Registry: registry.gitlab.com/ix.ai/alertmanager-notifier - gitlab.com/ix.ai/alertmanager-notifier
• GitHub Registry: ghcr.io/ix-ai/alertmanager-notifier github.com/ix-ai/alertmanager-notifier
• Docker Hub: ixdotai/alertmanager-notifier - hub.docker.com/r/ixdotai/alertmanager-notifier