Faultnotify 🐧

Faultnotify, Debian (+Derivate)
Wiki-Stand: 20.01.2026 - im Aufbau.
Script-Stand: 19.01.2026

Download

🚀 Vorwort

Faultnotify ist ein leichtgewichtiges, modular aufgebautes Bash-Script zur Überwachung von Geräten und Diensten.
Es wurde mit dem Ziel entwickelt, Störungen zuverlässig und frühzeitig zu erkennen. Dazu überprüft Faultnotify Geräte und Dienste fortlaufend und informiert im Fehlerfall automatisch per Benachrichtigung.

Alle benötigten Daten werden zentral in einem festen Verzeichnis abgelegt. Dort befinden sich unter anderem die Konfiguration, Statusinformationen sowie Steuer- und optional auch Sprachdateien. Dadurch bleibt alles übersichtlich an einem Ort.

Optional kann Faultnotify um zusätzliche Sprachdateien erweitert werden. In diesem Fall ist das Script in der Lage, Benachrichtigungen und Ausgaben in der jeweiligen Sprache bereitzustellen.

Faultnotify eignet sich sowohl für einzelne Systeme als auch für größere, verteilte Umgebungen. Es kommt bewusst ohne zusätzliche Software oder Datenbanken aus und bleibt dadurch einfach, robust und wartungsarm.

In verteilten Umgebungen können Geräte und Dienste zu Gruppen zusammengefasst werden. So wird sichergestellt, dass im Störungsfall nur gezielte und sinnvolle Benachrichtigungen ausgelöst werden.

Für den Dauerbetrieb empfiehlt sich die Einrichtung als Systemdienst. Dadurch läuft Faultnotify permanent im Hintergrund und bleibt auch nach Neustarts zuverlässig aktiv.

⚙️💡 Allgemein und Funktionsaufbau

Faultnotify legt sein zentrales Arbeitsverzeichnis unter /home/$USER/script-data/faultnotify an.
Falls eine Sprachdatei verwendet wird, ist diese hier einzupflegen: /home/$USER/scrupts-data/faultnotify/lang/xxx.txt.

Faultnotify wird zuerst über den Befehl install installiert und eingerichtet. Das Skript führt dabei interaktiv durch die Erstkonfiguration und legt die grundlegenden Einstellungen fest.

Während der Installation prüft Faultnotify, ob alle benötigten Programme auf dem System vorhanden sind. Fehlende Abhängigkeiten werden klar angezeigt und müssen eigenständig nachinstalliert werden.

Im Anschluss wird die gewünschte Art der Benachrichtigung festgelegt. Zur Auswahl stehen E-Mail oder Telegram. Abhängig von der Auswahl werden die erforderlichen Angaben abgefragt und in der Konfiguration gespeichert.

Bei der Einrichtung der Benachrichtigungen wird ein Verifizierungscode an die angegebene E-Mail-Adresse oder den gewählten Telegram-Account gesendet. Dieser Code muss zur Bestätigung eingegeben werden. Die Verifizierung dient dazu sicherzustellen, dass Benachrichtigungen im Störungsfall tatsächlich zugestellt werden und korrekt funktionieren.

Wird die Verifizierung übersprungen oder schlägt sie fehl, wird die Installation dennoch fortgesetzt. Die Benachrichtigungseinstellungen können später manuell angepasst werden, jedoch ohne erneute automatische Verifizierung. In diesem Fall liegt die vollständige Verantwortung für eine funktionierende Zustellung beim Nutzer. Es gibt aber einen Workaround: ~~hier.~~hier.

⚙📋 Geräteprüfung (TEST)

Dies ist die Hauptfunktion des Scripts. Sie prüft Geräte und Dienste und im Fehlerfall gibt sie Benachrichtigungen aus.

➕ Geräte/Dienste hinzufügen (ADD)

Mit Hilfe des Moduls add können Geräte hinzugefügt werden.

✏️ Modifizierung/Bearbeitung (MOD)

Mit Hilfe des Moduls mod können Geräte und Dienste bearbeitet oder gelöscht, sowohl auch Änderungen an der Konfiguration vorgenommen werden.

📜 Übersicht (DRAW)

Mit Hilfe des Moduls draw kann die Hierachie mit allen Abhängigkeiten übersichtlich angezeigt werden.

📜 Automation (ON/OFF)

Mit den Funktionsschalter on bzw. off lassen sich die dauerhaften Prüfungen ein- oder ausschalten. Wird im off-Modus geprüft, bleibt es bei einem einmaligen Durchgang. Im on-Modus wird dauerhaft geprüft, bis parallel off gesendet wird.

Hierbei wird im zentralen Verzeichnis des Scripts ein Datei-Flag gesetzt.

Aufruf:

$0 on
$0 off

Dann jeweils:

$0 test

🆘 Fehler / Troubleshooting

Wird während der Installation eine Eingabe wie die Benachrichtigung falsch getägigt oder die Verifizierung der Benachrichtigung übersprungen oder schlägt fehl, wird die Installation trotzdem weitergeführt. Die Verifizierung dient dazu, dass sichergestellt werden kann, dass im Störungsfall auch Benachrichtigungen ankommen können.
In diesem Fall kann im Verzeichnis script-data/faultnotify die Datei .installed gelöscht werden, um die Installation erneut zu starten und die Erstkonfiguration nochmals vollständig durchzuführen.