Open Source 2022

systemd Status Notifier

Ein Bash-Skript, das meldet, wenn ein systemd-Dienst ausfällt: per E-Mail, Slack, Mattermost, PagerDuty, Pushover oder SMS, einzeln oder in beliebiger Kombination.

Seit

2022

Lizenz

MIT

HTML-Mail zu einem ausgefallenen Dienst
6
Benachrichtigungskanäle
1
Bash-Skript
2
Modi: Liste oder alle Dienste
0
Agenten oder Daemons nötig

Technologien

Bash systemd sendmail Slack Mattermost PagerDuty Pushover sipgate SMS curl

Die Herausforderung

Fällt ein systemd-Dienst aus, merkt man es oft erst, wenn etwas anderes nicht mehr funktioniert. Große Monitoring-Systeme sind für einzelne Server oft zu viel, und jeder Kanal, ob E-Mail, Chat oder Pager, will anders angesprochen werden.

Die Lösung

Ein einzelnes Bash-Skript prüft ausgewählte oder alle aktivierten Dienste auf den Zustand „failed“ und meldet Ausfälle über die konfigurierten Kanäle. Jede Nachricht nennt Host, Dienst, Beschreibung und Zeitpunkt.

So arbeitet das Skript

Erkennen

systemctl list-unit-files und systemctl is-failed prüfen eine Liste von Diensten oder alle aktivierten Units, mit einer Ausnahmeliste.

Melden

HTML-Mail über sendmail, Slack und Mattermost per Webhook, Pushover und SMS per API, PagerDuty über pd-send; jeder Kanal einzeln schaltbar.

Auslösen

Das Skript läuft pro Aufruf einmal durch und wird als systemd-Dienst oder per Cron gestartet; eine Unit-Vorlage liegt bei.

Nachrichten

Jede Meldung nennt Hostname, Dienst mit Beschreibung und einen Zeitstempel. Mattermost bekommt eine Markdown-Tabelle, E-Mail eine HTML-Nachricht.

Konfiguration

Kanäle, Empfänger, Webhooks und Schlüssel werden im Skript als Variablen eingetragen; die Vorlage enthält nur Platzhalter.

Einsatz und Lizenz

Das Skript braucht Bash, systemd und für E-Mail einen lokalen Mailserver; die übrigen Kanäle laufen über curl, PagerDuty über pd-send. Der Code steht unter der MIT-Lizenz auf GitHub.

Datenschutz

Das Skript sendet nur Ausfallmeldungen an die selbst eingetragenen Kanäle.

Ergebnisse

Ein schlanker Wächter für einzelne Server, der Ausfälle sofort dorthin meldet, wo man sie sieht.

Galerie

Ausgabe des Skripts in einer Testumgebung mit einem Beispieldienst.