StateGuard überwacht die Entitäten und Geräte, die man in Home Assistant mit einem Label versehen hat, und meldet sich, wenn etwas nicht stimmt: Ein Gerät ist nicht mehr verfügbar, ein Sensor meldet nichts mehr oder ein Wert überschreitet eine Grenze. Konfiguriert wird in einem eigenen Panel in der Seitenleiste statt in YAML.
Bedingungen
- nicht verfügbar oder unbekannt
- keine Daten seit einer vorgegebenen Zeit, gemessen an
last_reported - numerischer Schwellwert mit eigenem Erholungswert
- Zustand ist (nicht) ein bestimmter Wert
- zu lange in einem Zustand
- Entität existiert nicht mehr
Ruhe statt Alarmflut
Eine Karenzzeit nach dem Neustart (standardmäßig zehn Minuten, mit sichtbarem Countdown), eine einzige Nachricht, wenn eine Integration oder Bridge ausfällt, Ruhezeiten in mehreren Zeiträumen sowie Schlummern und Bestätigen pro Entität oder Watch halten die Meldungen übersichtlich. Was man selbst verlangt (schlummern, pausieren), zieht eine stehende Meldung zurück; was das System entscheidet (Neustart, kein Internet), hält nur neue zurück.
Oberfläche
Das Panel enthält Übersicht, Watch-Editor mit Live-Vorschau der abgedeckten Entitäten, Kanäle, frei definierbare Schweregrade, Störungsverlauf und Einstellungen. Fünf Vorlagen helfen beim Start: Verfügbarkeit, Akku schwach, Keine Daten, Sicherheitsgeräte, Fehlende Entitäten. Die Lovelace-Karte custom:stateguard-card registriert sich selbst, hat einen visuellen Editor und funktioniert für alle Nutzer, auch ohne Adminrechte. Panel und Karte sind in elf Sprachen übersetzt.
Benachrichtigungen
Jeder Home-Assistant-Dienst sowie SMTP, Telegram, Pushover und ntfy mit eigenen Zugangsdaten. Jeder Kanal kann eigene Jinja2-Texte tragen und hat eine Test-Schaltfläche. Zusätzlich löst StateGuard das Ereignis stateguard_alert aus und bringt Dienste zum Schlummern, Bestätigen, Pausieren, Prüfen sowie zum Export und Import der Konfiguration mit.
Installation
Voraussetzung ist Home Assistant 2026.1 oder neuer. In HACS https://github.com/sphings79/stateguard-home-assistant als benutzerdefiniertes Repository der Kategorie „Integration“ hinzufügen, StateGuard installieren, neu starten und die Integration unter Geräte & Dienste hinzufügen. Alternativ lässt sich custom_components/stateguard manuell kopieren. Der Verlauf liegt in einer eigenen Datenbank neben der Konfiguration, die Aufbewahrung beträgt standardmäßig 90 Tage.
Alles läuft lokal. Mit Watchman überschneidet sich StateGuard teilweise; beide können nebeneinander laufen.