Alerter

Telegram bot for alerts from Alertmanager

Usage

1. Create bot with BotFather and get token.

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

3. Configure alerter.

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

   ```text receivers:

   • name: alerter webhookconfigs:
     • sendresolved: true url: 'http://127.0.0.1:48655' ```

Installation

Prebuilt packages

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

Docker

Pull image from DockerHub:

sh docker pull ultram4rine/alerter

In other cases, you need Rust installed.

Crates.io

You can install alerter from crates.io:

sh cargo install alerter

Then download template and run.

Build from source

1. Clone repository:

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

2. Build binary:

   sh cargo build --release

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

Build Deb or RPM package

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

Configuration

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

| Environment variable | Command-line flag | Default | Description | | -------------------- | ----------------- | --------------------- | --------------------------------- | | ALERTERLISTENPORT | --port (-p) | 48655 | Port to listen. | | ALERTERTMPLPATH | --template-path | templates/default.hbs | Path to handlebars template file. | | ALERTERTGBOTTOKEN | --token | | Telegram bot token. | | ALERTERTGCHATID | --chat-id | | Telegram chat ID. |