1 unstable release

0.1.0 Mar 3, 2023

#30 in #enable-debug

Apache-2.0

79KB
2K SLoC

mawby -- Matrix Alertmanager Webhook Bot? Yes!

Running

The easiest way right now is to use the container packaging. Builds are automatically uploaded to quay.io/upto/mawby. Three label types are available:

  • latest: Latest stable version
  • master: Latest version from the master branch
  • <version, such as v0.1.0>: Static version

Inside the container, mawby is running as an unprivileged user (mawby, uid/gid 9823/9823). By default, the configuration is read from /etc/mawby/mawby.conf, and it requires a writeable data directory at /var/lib/mawby (possible to change in config).

To print a commented configuration template, run the application (or the container) with the argument --print-config-template.

Using

mawby expects WebhookV4 alerts to be posted to /alerts/<endpoint name>. Using the routing statements, this alert will be routed to the expected room. For example, with this alertmanager.yml fragment:

receivers:
  - name: service_a
    webhook_configs:
      - url: http://<mawby-host>:9823/alerts/service_a

And this mawby.yaml fragment:

rooms:
  team1: '#team1:example.org'

routes:
  service_a:
    room: team1

Alerts that are routed to the service_a receiver in alertmanager will end up in #team1:example.org.

Dependencies

~35–52MB
~1M SLoC