Telegram and Matrix bot for alerts from Alertmanager

1. Create bot with BotFather and get token.

2. Get your, group or channel chat id with Get My ID bot.

1. Create user under which alerter will work.

2. Add this user to room for alerts and get room_id.

After preparations:

1. Configure alerter.

2. Optionally check that messages are being sent and formatted correctly using this script:

   ./test.sh tg

   Or

   ./test.sh matrix

3. Add alerter to receivers in your alertmanager.yml:

   receivers:
     - name: alerter_tg
       webhook_configs:
         - send_resolved: true
           url: "http://127.0.0.1:3030/tg"
     - name: alerter_matrix
       webhook_configs:
         - send_resolved: true
           url: "http://127.0.0.1:3030/matrix"

You can modify default templates for your needs, they are in Handlebars format. For Telegram alerter uses HTML style and for Matrix Markdown style.

You can download prebuilt archive or Deb/RPM package from releases.

Pull image from DockerHub:

docker pull ultram4rine/alerter

In other cases, you need Rust installed.

You can install alerter from crates.io:

cargo install alerter

Then download needed template and run.

1. Clone repository:

   git clone https://github.com/ultram4rine/alerter.git
   cd alerter

2. Build binary:

   cargo build --release

3. Binary should be in target/release/alerter.

See cargo-deb or cargo-generate-rpm instructions respectively.

Use environment variables or command-line flags to configure alerter: