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.

Neu ist die eingeführte Gruppenlogik. Diese entstand aus der praktischen Anforderung heraus, Benachrichtigungsfluten zu vermeiden. Ein typisches Beispiel ist die Überwachung einer VPN-Verbindung mit mehreren dahinterliegenden Geräten oder Diensten.

Fällt in einem solchen Szenario die VPN-Verbindung aus, wären die nachgelagerten Geräte zwangsläufig ebenfalls nicht erreichbar. Ohne Gruppierung würde dies zu einer Vielzahl gleichzeitiger Störungsmeldungen führen, obwohl die eigentliche Ursache nur der VPN-Ausfall ist.

Durch die Gruppenbildung wird dieses Problem gezielt verhindert. Wird ein Gerät oder Dienst als abhängig von der VPN-Überwachung angelegt, prüft Faultnotify zuerst den übergeordneten Eintrag. Ist dieser nicht erreichbar, werden die untergeordneten Prüfungen ausgesetzt und es erfolgt keine weitere Benachrichtigung für die abhängigen Geräte.

Erst wenn die VPN-Verbindung wieder verfügbar ist, werden die nachgelagerten Geräte erneut geprüft. Auf diese Weise bleibt die Benachrichtigung aussagekräftig, übersichtlich und auf die tatsächliche Ursache beschränkt.

📋 Geräteprüfung (TEST)

Das Modul test ist die zentrale Prüffunktion von Faultnotify. Es prüft alle in der Konfiguration hinterlegten Geräte und Dienste und erkennt Störungen sowie Wiederherstellungen.

Bei direktem Aufruf führt test genau einen vollständigen Durchlauf aus. Das bedeutet:

Alle Geräte und Dienste werden einmal geprüft.
Im Fehlerfall werden Benachrichtigungen ausgelöst.
Danach endet der Durchlauf automatisch.

🏭 Automation (RUN)

Dies ist der Dauerschleifen-Modus. Hier werden permanent mit einem Versatz von 5 Sekunden die in der Konfiguration eingerichteten Geräte und Dienste geprüft.

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

Mit dem Modul add können neue Geräte und Dienste interaktiv zur Überwachung hinzugefügt werden. Der Vorgang ist dialoggeführt aufgebaut und kann mehrfach hintereinander ausgeführt werden, um mehrere Einträge nacheinander anzulegen.

Zu Beginn ermittelt Faultnotify automatisch die nächste freie Geräte-ID. Diese wird fortlaufend vergeben.

Im Anschluss werden Schritt für Schritt folgende Angaben abgefragt:

Name des Geräts oder Dienstes
Der Anzeigename dient ausschließlich der Übersicht. Kritische Zeichen werden automatisch bereinigt, um die Konfigurationsdatei konsistent zu halten.
IP-Adresse oder Domain
Es kann entweder eine IPv4-Adresse oder ein gültiger Domainname angegeben werden.
Dienstüberwachung (optional)
Falls ein Dienst überwacht werden soll, wird der zu prüfende Port abgefragt.
Optional kann festgelegt werden, ob es sich um einen UDP-Dienst handelt. Wird kein Port angegeben, behandelt Faultnotify den Eintrag als reines Gerät (Ping-Prüfung).
Abhängigkeit von einem Master-Gerät (optional)
Geräte und Dienste können einem bestehenden Eintrag untergeordnet werden. Dadurch lassen sich Abhängigkeiten abbilden, zum Beispiel:
- Dienste hängen von einem Server ab
- Untergeräte hängen von einem Hauptgerät ab
Ist kein Master angegeben, wird der Eintrag automatisch der Root-Gruppe (G000) zugeordnet.

Nach Abschluss der Eingaben wird der neue Eintrag:

in die Konfigurationsdatei geschrieben
im internen Log protokolliert
sofort für künftige Prüfungen berücksichtigt

Der Hinzufügen-Modus kann jederzeit durch eine leere Eingabe beim Namen beendet werden. Nach dem ersten erfolgreichen Hinzufügen wird Faultnotify als „eingerichtet“ markiert, sodass die Überwachung genutzt werden kann.

Hinweis zur Gruppenlogik:

Die Gruppenlogik entstand aus der praktischen Anforderung heraus, Benachrichtigungsfluten zu vermeiden. Ein typisches Beispiel ist die Überwachung einer VPN-Verbindung mit mehreren dahinterliegenden Geräten oder Diensten.

✏️ Modifizierung/Bearbeitung (MOD)

Mit dem Modul mod können bestehende Einträge verwaltet werden.

Typische Aufgaben:

Geräte oder Dienste neu hinzufügen
Geräte oder Dienste ersatzlos löschen
Einstellungen der Konfiguration anpassen

Damit eignet sich mod für die laufende Pflege, wenn sich Strukturen oder Zuständigkeiten ändern.

📜 Übersicht (DRAW)

Mit dem Modul draw kann die komplette Geräte- und Dienststruktur übersichtlich als Baum angezeigt werden. Dabei werden alle Abhängigkeiten berücksichtigt, sodass auf einen Blick sichtbar ist, welche Geräte oder Dienste untergeordnet sind und welche als übergeordnete „Master“-Ebene dienen.

Die Darstellung beginnt bei ROOT (G000) und zeigt darunter alle Einträge aus der Konfiguration in einer klaren Hierarchie. Zusätzlich werden die wichtigsten Informationen direkt in der Ausgabe mitgeführt:

ID des Eintrags
Name bzw. Beschreibung
IP-Adresse
optional Port und Protokoll (TCP/UDP)

Fehlerhinweis bei ungültigen Abhängigkeiten
Falls ein Eintrag auf ein nicht vorhandenes Master-Gerät verweist, gibt draw einen Hinweis aus und listet die betroffenen Einträge auf. Dadurch lassen sich fehlerhafte Abhängigkeiten schnell erkennen und anschließend über mod korrigieren.

🆘 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.