Skip to main content

Matrix AlertBot Built with matrix-nio coverage report

A bot that receives alert from Alertmanager to send them to a Matrix room. Users can interract with the bot to create silences for the alerts.

Features include:

  • Send alerts from Alertmanager to a Matrix room
  • Add a reaction to an alert to create a silence until the alert is resolved
  • Reply to an alert to create a silence with a given duration
  • Reply to an alert to create a silence until the alert is resolved
  • Remove silences created through the bot
  • Participation in end-to-end encrypted rooms

Getting started

See SETUP.md for how to setup and run the bot.

See CONTRIBUTING.md for how to contribute to the project.

Project structure

The majority of the code is kept inside of the matrix_alertbot folder, which is in itself a python package, the __init__.py file inside declaring it as such.

To run the bot, the matrix-alertbot script in the root of the codebase is available. It will import the main function from the main.py file in the package and run it. To properly install this script into your python environment, run pip install -e . in the project's root directory.

setup.py contains package information (for publishing the code to PyPI) and setup.cfg just contains some configuration options for linting tools.

config.sample.yaml is a sample configuration file. You should copy this file to config.yaml , then edit it according to your needs. Be sure never to check the edited config.yaml into source control since it'll likely contain sensitive details such as passwords!

Metadata

Release files for matrix-alertbot 0.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for matrix-alertbot 0.3.3
File Size Uploaded
matrix_alertbot-0.3.3.tar.gz 63.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for matrix-alertbot 0.3.3
File Interpreter ABI Platform
matrix_alertbot-0.3.3-py3-none-any.whl Python 3 none any Details

Total release size: 124.8 kB

Release files / matrix_alertbot-0.3.3.tar.gz

Download URL matrix_alertbot-0.3.3.tar.gz
Size 63.6 kB
Tags Source
SHA-256 checksum
How to use checksums
57bda2b81051f6b1e294d1de6c1b6cf034bc2ce333b18860dd7db3eb9fb5d063
BLAKE2b-256 checksum
How to use checksums
9efd9916364046a29a1adce91731d792c1bf92f74dc25ffd42f823c8b867ff47
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.10

Release files / matrix_alertbot-0.3.3-py3-none-any.whl

Download URL matrix_alertbot-0.3.3-py3-none-any.whl
Size 61.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5272c388fea959172536c610c66104ba10192c137c61f9592eb70b9ba7b5e6ff
BLAKE2b-256 checksum
How to use checksums
2a77b4c332c1dceb00a1fd976e8c92d23002e0084f49b69d81aaf6ed5d6a790d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.1.1 CPython/3.11.10

Release history Release notifications | RSS feed

This release

0.3.3 This release

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.3.0

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page