{"repo":"moan0s/alertbot","free":true,"listed":false,"github":"https://github.com/moan0s/alertbot","clone":"git clone https://github.com/moan0s/alertbot.git","description":"A bot that receives a webhook and forwards alerts to a matrix room","language":"Python","stars":28,"topics":["alertmanager","grafana","monitoring","prometheus","webhook"],"license":"AGPL-3.0","category":"analytics","readme_excerpt":"Alertbot This bot uses the webhook functionality of monitoring/alerting solutions like Grafana or Alertmanager to forward alerts to matrix rooms. This means that you no longer have to use E-Mail or Slack to receive alerts. Getting Started You can either invite an official instance of the bot, or self-host it on your own matrix server. Invite the Official Instance Create a Matrix room and invite @alertbot:hyteck.de Send !url to the room. The bot will answer with the webhook URL Put the Webhook URL into your monitoring solution (see below) Self-host an Instance Prerequisites: A Matrix server where you have access to a maubot instance Refer to the docs for setting up one or use spantaleev/matrix-docker-ansible-deploy which has built-in maubot support An instance of alertmanager or grafana or a similar alerting program that is able to send webhooks Build the Bot The bot is built using the maubot command line tool mbc , you can either build it locally or remotely. Build it locally, and afterwards navigate to the Maubot Administration Interface and upload the .mpb file. It's possible to upload the build to you maubot instance from the CLI. This is especially helpful when developing. First login to your instance, then add the -u flag to upload after build. Configure the Bot Next, once the plugin is installed, set up a client and then create an instance which connects the client and plugin. Finally, invite the bot to an encrypted room where alerts should be sent and query the bot for","default_branch":null,"files":null,"tree":[],"storefront":"/r/moan0s","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/moan0s/alertbot/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}