Kener Smart-Home-Integration, kostenlos und Open Source
Deine Kener-Statusseite in Gladys: Monitore, Verfügbarkeit, Vorfälle und Szenen bei Ausfall.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Kener ist eine selbst gehostete Statusseite, die deine Dienste (Websites, APIs, Ports, DNS…) jede Minute prüft und ihren Zustand und ihre Vorfälle veröffentlicht. Diese Integration bringt sie in Gladys: Jeder Monitor wird ein Gerät mit Zustand, Antwortzeit und Verfügbarkeit, Szenen reagieren, wenn einer ausfällt, zurückkommt oder ein Vorfall eröffnet wird, und ein Dashboard-Widget zeigt Vorfälle und Monitore auf einen Blick.
Gladys liest Kener: sie prüft deine Dienste nicht selbst.
Getestet mit einem echten Kener in Docker (Kener 4.1.10): Monitore online, ausgefallen und beeinträchtigt, ein Monitor ohne Daten, offene und beendete Vorfälle, ein falscher API-Schlüssel. Rückmeldungen gern in den Issues.
Was du brauchst
- Gladys Assistant 5.1.0 oder neuer.
- Kener 4 (die API v4), von Gladys aus erreichbar: in deinem Netzwerk (standardmäßig Port 3000) oder im Internet. Kener 3 wird nicht unterstützt.
- Einen Kener-API-Schlüssel.
Erste Schritte
1. Einen API-Schlüssel in Kener erstellen
Öffne in Kener Manage → API Keys, erstelle einen Schlüssel (zum Beispiel „Gladys“) und kopiere ihn: Kener zeigt ihn nur einmal an. Ein Kener-API-Schlüssel kann auch schreiben (Vorfälle, Monitore anlegen): Diese Integration liest nur, behalte den Schlüssel aber für dich.
2. Die Integration konfigurieren
In Gladys, Integrationen → Kener → Konfiguration:
- Kener-Adresse: die Adresse deiner Statusseite, zum Beispiel
http://192.168.1.2:3000oderhttps://status.example.com. Eine aus dem Browser kopierte URL (…/monitors/meine-api) geht auch. Läuft Kener unter einem Unterpfad (KENER_BASE_PATH), gib ihn mit an. - API-Schlüssel: der Schlüssel aus Schritt 1.
- Aktualisierungsintervall: 1, 2 oder 5 Minuten. Kener schreibt einen Punkt pro Minute.
- Ausgeblendete Monitore einbeziehen: standardmäßig aus, die auf der Statusseite ausgeblendeten Monitore werden weggelassen.
- Sprache der Namen: die Sprache der Funktionsnamen und der Szenen-Ergebnisse.
Verbindung testen liest Kener sofort und sagt, wie viele Monitore gefunden wurden, wie viele ausgefallen sind und welche Vorfälle laufen.
3. Die Monitore hinzufügen
Lege im Tab Entdecken die Monitore an, die du verfolgen willst, und das Gerät „Kener“ für die ganze Instanz. Pausierte Monitore werden nicht angeboten. Ein Monitor wird über seinen Tag erkannt: Ihn in Kener umzubenennen behält das Gerät, seinen Tag zu ändern erzeugt ein neues.
Die Geräte
Jeder Monitor:
| Funktion | Wert |
|---|---|
| Online | Ja bei online oder beeinträchtigt, Nein bei Ausfall |
| Beeinträchtigt | Ja, wenn Kener ihn als beeinträchtigt zeigt |
| Antwortzeit | Latenz der letzten Prüfung ohne Ausfall, in ms |
| Verfügbarkeit 24 h | Über die letzten 24 Stunden, mit der Formel von Kener |
Das Gerät „Kener“: Ausgefallene Monitore, Beeinträchtigte Monitore, Laufende Vorfälle.
Antwortzeit und Verfügbarkeit werden höchstens alle 5 Minuten gesendet (sofort bei einer Zustandsänderung), damit eine große Statusseite Gladys nicht belastet. Die Geräte tragen das Cloud-Abzeichen, wenn Kener im Internet ist, das lokale, wenn es in deinem Netzwerk ist.
Dashboard
Das Widget Kener zeigt vier Kacheln (ausgefallene und beeinträchtigte Monitore, laufende Vorfälle, mittlere Verfügbarkeit), dann die laufenden Vorfälle mit ihrem Zustand, dann die Monitore, ausgefallene zuerst, mit Antwortzeit und Verfügbarkeit. Ab zehn Monitoren werden sie nach Kener-Kategorie zusammengefasst („Ausgefallen: 1 / 7“).
Einstellungen: eine Kategorie oder gewählte Monitore (nur die in Gladys angelegten Geräte); Laufende Vorfälle anzeigen; Schaltfläche „Aktualisieren“ anzeigen. Die Schaltfläche Aktualisieren liest Kener sofort. Mit einer Kategorie oder gewählten Monitoren zählen nur deren Vorfälle.
Szenen
Auslöser
- Ein Monitor fällt aus: Kener erfasst einen Monitor als ausgefallen. Es bestätigt einen Zustand schon, bevor es ihn schreibt (seine „confirmation threshold“). Filter: die Monitore (leer: alle, in Gladys angelegt oder nicht). Variablen: Name des Monitors, Kategorie.
- Ein Monitor ist wieder online: Ein ausgefallener Monitor ist wieder online oder beeinträchtigt. Variablen: Name des Monitors, Kategorie, Dauer des Ausfalls in Minuten (ab seinem ersten Ausfallpunkt).
- Ein neuer Vorfall wird eröffnet: Ein laufender Vorfall erscheint auf der Statusseite, von Hand, über die API oder durch einen Kener-Alarm erstellt. Variablen: Titel, betroffene Monitore, Seite des Vorfalls.
Eine Änderung, während Gladys oder die Integration gestoppt war, wird beim nächsten Lesen trotzdem einmal gemeldet.
Aktionen
- Zustand eines Monitors: online, beeinträchtigt, Zustand in Worten, Name, Kategorie, Antwortzeit, Verfügbarkeit 24 h und ein Satz wie „NAS: Ausgefallen, 97,5 % in 24 h.“
- Zusammenfassung der Statusseite: ausgefallene, beeinträchtigte und alle Monitore, Namen der ausgefallenen, laufende Vorfälle und ihre Titel und ein Satz wie „Ausgefallen: NAS. Laufende Vorfälle: Backup-Server nicht erreichbar.“ Optionales Feld: eine Kategorie.
Beide lesen Kener neu, wenn das letzte Lesen älter als 15 Sekunden ist.
Szenen-Ideen
- Ein Monitor fällt aus → eine Nachricht mit dem Namen des Monitors senden.
- Jeden Morgen Zusammenfassung der Statusseite → den Satz nur dann auf dem Lautsprecher vorlesen, wenn ein Monitor ausgefallen ist.
- Ein neuer Vorfall wird eröffnet → mit Titel und Link der Seite benachrichtigen.
Fehlerbehebung
- „Kener antwortet nicht“: Prüfe Adresse und Port vom Rechner von Gladys aus und ob eine Firewall blockiert.
- „API-Schlüssel abgelehnt“: Erstelle einen neuen Schlüssel unter Manage → API Keys; ein deaktivierter Schlüssel wird auch abgelehnt.
- „Kein Kener 4 unter dieser Adresse“: Die Adresse ist kein Kener oder ein Kener 3 (ohne API v4). Prüfe den Unterpfad, falls Kener einen hat.
- „Die Adresse leitet um“: Gib direkt die
https://-Adresse ein. - „Zertifikat abgelehnt“: Ein selbstsigniertes Zertifikat wird nicht
akzeptiert; nutze die
http://-Adresse in deinem Netzwerk. - Ein Monitor bleibt ohne Wert: Kener hat noch keinen Datenpunkt für ihn.
Grenzen
- Gladys liest Kener im gewählten Intervall: Ein kürzerer Ausfall kann den Auslösern entgehen (die Verfügbarkeit zählt ihn trotzdem).
- Die Verfügbarkeit wird aus den Datenpunkten der letzten 24 Stunden berechnet, mit der Formel des Monitors, wenn sie eine einfache Summe ist (sonst mit der Standardformel). Wartungsfenster werden nicht gelesen.
- Wartungen, Kommentare zu Vorfällen und Seiten werden nicht gelesen.
- Die Integration liest nur: sie legt keine Vorfälle in Kener an.
- Der Zustand eines Monitors ist sein neuester Datenpunkt: Hört Kener auf zu prüfen (Kener oder sein Redis gestoppt), bleibt der letzte Zustand, bis seine Punkte älter als 24 Stunden sind. Ein in Kener pausierter, ausgeblendeter oder gelöschter Monitor macht sein Gerät unerreichbar.
- Nicht mit Kener oder seinem Autor verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Kener in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Kener | section | Nein | Gib die Adresse deines Kener (Version 4) und einen API-Schlüssel ein. Lege dann die zu verfolgenden Monitore im Tab „Entdecken“ an: Gladys liest Kener, sie prüft deine Dienste nicht selbst. |
| Kener-Adresse | string | Ja | Adresse deiner Statusseite (standardmäßig Port 3000), mit ihrem Unterpfad, falls Kener einen hat. |
| API-Schlüssel | secret | Ja | In Kener erstellt: Manage → API Keys. Kener zeigt ihn nur einmal an: Kopiere ihn sofort. |
| Optionen | section | Nein | |
| Aktualisierungsintervall | select | Nein | Wie oft Kener gelesen wird: eine Anfrage für die Liste, eine pro Monitor, eine für die Vorfälle. |
| Ausgeblendete Monitore einbeziehen | boolean | Nein | Die auf der Statusseite ausgeblendeten Monitore werden standardmäßig weggelassen. |
| Sprache der Namen | select | Nein | Sprache der Funktionsnamen (beim Anlegen eines Geräts festgelegt) und der Szenen-Ergebnisse. |
So installierst du Kener in Gladys
- Öffne in Gladys Integrationen: Kener erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-kener:1.0.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/guim31/gladys-kener.
Kener benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Kener ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von guim31 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation