prometheus_tbot

prometheus_tbot

rewrite-in-progress prometheus telegram bot

Features

• multi-chat sending
• ability to define separate template for each chat

Usage

1. Create Telegram bot with BotFather, it will return your bot token

2. Create configuration config.yaml:

  telegram_token: "token goes here"

  layouts:
    prometheus:
      |
        {{if eq .PageNumber 0 }}
          {{- if eq .Alerts.Status "firing"}}<b>Firing 🔥</b>{{ end -}}
          {{- if eq .Alerts.Status "resolved" }}<b>Resolved ✅</b>{{ end -}}
        {{ else }}
        ...
        {{- end }}
        {{ template "messages" .PageMessages }}`
        
  messages_layouts:
    prometheus:
      |
        <b>{{ .Annotations.message }}</b>
        <code>{{ .Labels.alertname }}</code> [ {{ .Labels.k8s }} / {{ .Labels.severity }} ]

    prometheus_mini:
      |
        <b>{{ .Annotations.message }}</b>

    prometheus_grouped:
      |
        <b>{{ .Annotations.message }}</b> [ {{ .Labels.k8s }} / {{ .Labels.severity }} ]
        
  chats_layouts:
    "-228572021":
      layout: prometheus
      message_template: prometheus_mini

    "46733847":
      layout: prometheus
      message_template: prometheus
      group_by_alert_name: true

1. Run telegram_tbot with command lines options or env variables described in section below

2. Write /chatid command in any chat with tbot and receive ChatId

Command lines options & environment variables

Any command line argument can be set through ENV variables, equality table below:

var:                 flag:      env:

Config Path          -c        TBOT_CONFIG_PATH
Port                 -p        TBOT_PORT
Telegram Token       -t        TBOT_TELEGRAM_TOKEN
Debug                -d        TBOT_DEBUG

Examples:

run with arguments

./prometheus_tbot -c path/to/config.yml -p 9000 -t TOKEN

run with environment variables (all vars prefixed with TBOT)

TBOT_CONFIG_PATH=path/to/config.yml TBOT_PORT=9000 TBOT_TELEGRAM_TOKEN=TOKEN ./prometheus_tbot

run with proxy

HTTP_PROXY=socks5://telegram:login@server:8080 ./prometheus_tbot -c path/to/config.yml -p 9000 -t TOKEN

Configuring alert manager

Alert manager configuration file:

- name: 'admins'
  webhook_configs:
  - send_resolved: True
    url: http://127.0.0.1:9087/alert/-chat_id_1/-chat_id_2/-chat_id_n

TODO:

• better crash reports
• [?] notify panic's with honeybadger
• [readme] templates
• write tests
• [late] add ability to test templates