alerta

Alerta + Telegram intrigration

Alerta einfach erklärt: Installation, Docker-Setup, Telegram-Alerts. Praxisnah geschrieben, damit du nicht wie ich stundenlang an halbgaren Dokumentationen verzweifelst.

Fabian

• 3 min read
Alerta + Telegram intrigration
Bild: alerta / Github

Heute zeigen ich euch, wie ihr Alerta installieren und mit Telegram betreiben könnt.

Quellen:

GitHub - alerta/alerta: Alerta monitoring system
Alerta monitoring system. Contribute to alerta/alerta development by creating an account on GitHub.
GitHubalerta

Was ist Alerta eigentlich?
Kurz gesagt: Alerta ist kein Monitoring-Tool, sondern dein Alarm-Manager.
Es sammelt Meldungen von Tools wie Prometheus, Nagios, Zabbix oder Uptime Kuma und packt sie in eine zentrale Übersicht. Anstatt dass dir jedes System einzeln dein Handy zuspammt, fasst Alerta alles zusammen, normalisiert die Events und zeigt dir, was wirklich wichtig ist – mit Prioritäten, Status und Eskalationen.

💡
Wichtig: Monitoring selbst machst du weiter mit deinen Tools. Alerta kümmert sich nur um die Flut an Benachrichtigungen, also ist eine Art Sammelstelle.

Warum Alerta?

  • ✅ Schluss mit der typischen Alert-Flut.
  • ✅ Du kannst Regeln setzen: Suppression, Blackout, Deduplikation.
  • ✅ Web-UI, API und haufenweise Integrationen sind direkt dabei.
  • ✅ Mit Plugins wie Telegram-Bot bekommst du nur noch die Meldungen, die wirklich zählen.

So kannst du es dir vorstellen

  • Alerta ist wie der Dispatcher zwischen deinen Systemen und dir.
  • Deine Checks laufen ganz normal (CPU, Container Health, Dienste, …). Wenn die rot gehen, knallt dir Alerta die Meldungen nicht einfach roh aufs Handy, sondern bündelt, filtert und sortiert sie.
  • Du bestimmst, wie und wann du benachrichtigt wirst – zum Beispiel nur außerhalb von Wartungsfenstern oder erst, wenn ein Dienst mehrfach ausfällt.

Systemanforderungen:

Keine Sorge, Alerta frisst keine Ressourcen. Wenn Docker bei dir sauber läuft, läuft auch Alerta – ganz ohne Spezial-Hardware oder teures Setup. Für den Einstieg reicht im Grunde jede halbwegs aktuelle Maschine.

⚠️ Für produktive Umgebungen empfehle ich:

  • Ubuntu 22.04
  • 2+ vCPU
  • 2 GB RAM
  • ~200 MB Speicherplatz
  • PostgreSQL als Datenbank (statt MongoDB)
  • Aktuelles Docker + docker-compose

Vorbereitung und installation

Ihr solltet Ubuntu 22.04 schon am Laufen haben, fehlt noch Docker und Docker Compose.

apt update && apt upgrade -y

Danach direkt Docker + Compose installieren:

apt install docker.io docker-compose -y

Jetzt legen wir einen Ordner für Alerta an und wechseln rein:

mkdir -p /opt/alerta && cd /opt/alerta

Docker-compose.yaml erstellen

Datei anlegen:

nano docker-compose.yaml

👉 Inhalt der Datei:

version: '2.1'
services:
  web:
    image: alerta/alerta-web
    ports:
      - "8080:8080"
    depends_on:
      - db
    environment:
      - DATABASE_URL=postgres://postgres:postgres@db:5432/monitoring
      - AUTH_REQUIRED=True
      - ADMIN_USERS=admin@alerta.io,devops@alerta.io # default password: alerta
      - ADMIN_KEY=demo-key  # unbedingt ändern – nehmt hier ein starkes eigenes Passwort!
      - PLUGINS=reject,blackout,normalise,enhance,telegram
      - TELEGRAM_TOKEN=[TELEGRAM_BOT_TOKEN] # hier euren Bot-Token eintragen (bekommt ihr über den BotFather in Telegram)
      - TELEGRAM_CHAT_ID=[CHAT_ID]
    restart: always

  db:
    image: postgres
    volumes:
      - ./pg-data:/var/lib/postgresql/data
    environment:
      POSTGRES_DB: monitoring
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    restart: always

💡 Wichtig:

  • ADMIN_KEY -> auf keinen Fall bei „demo-key“ lassen. Das ist euer Admin-API-Key, also stark und einzigartig wählen.
  • TELEGRAM_TOKEN -> muss euer echter Bot-Token vom BotFather sein, sonst klappt keine Benachrichtigung.
  • TELEGRAM_CHAT_ID -> Muss auch gesetzt sein, wird im nächsten Abschnitt erklärt.

Telegram-ChatID holen

Die ChatID bekommt ihr über:

https://api.telegram.org/bot<BOT TOKEN>/getUpdates
😉
Den Bot vorher mindestens einmal anschreiben, sonst steht da nichts und ihr sucht euch nen Wolf.

Starten und einloggen

Container starten:

docker-compose up -d

Dann im Browser aufrufen: http://<IP-Adresse>:8080

Weil AUTH_REQUIRED=True gesetzt ist, müsst ihr euch anmelden. Standard-Logins (stehen auch in der Compose-Datei):

Fertig! 🎉

Wenn alles geklappt hat, läuft Alerta jetzt auf deinem Server und nimmt die ersten Alerts entgegen.

💡 Nächste Schritte:

  • Eigene Regeln definieren (Blackouts, Deduplikation, Suppression)
  • Weitere Plugins ausprobieren
  • Alerta an dein Monitoring (Prometheus, Uptime Kuma, …) anbinden

Viel Spaß beim Basteln – und denk dran: je sauberer deine Regeln, desto entspannter dein Handy 😉