Elasticsearch / OpenSearch Smart-Home-Integration, kostenlos und Open Source

Zustand deines Elasticsearch- oder OpenSearch-Clusters: Status, Shards, Knoten, Platten, Szenen.
Der Zustand deines Elasticsearch- oder OpenSearch-Clusters in Gladys: Status, Knoten, Shards, Platten, Szenen-Auslöser und ein Widget. Nur lesend: Die Integration schreibt nie in den Cluster.
Getestet mit echten Clustern Elasticsearch 8.19 und OpenSearch 2.19 (in Docker, mit und ohne Sicherheit). Rückmeldungen sind willkommen auf GitHub.
Was du bekommst
Im Tab Entdecken ein Gerät für den Cluster und eines pro Knoten.
Das Cluster-Gerät:
- Status (0 grün, 1 gelb, 2 rot): der Zustand des Clusters. Gelb: ein Replikat ist nicht zugewiesen (normal auf einem einzelnen Knoten mit Replikaten). Rot: ein primärer Shard fehlt, Daten sind nicht durchsuchbar.
- Knoten, Datenknoten, Aktive Shards, Nicht zugewiesene Shards.
- Indizes, Dokumente, Größe der Indizes (GB).
- Version: das Produkt und seine Version, z. B.
OpenSearch 2.19.3.
Jedes Knoten-Gerät:
- Belegter Datenträger, Belegter JVM-Heap, Prozessor (%), Last (1 min).
- Shards: die Shards, die er hält.
- Im Cluster: 1, solange der Knoten zum Cluster gehört, 0, sobald er ihn verlassen hat (sein Abzeichen zeigt dann „nicht erreichbar“).
Konfiguration
-
Ist die Sicherheit aktiv (Standard bei Elasticsearch 8), lege für Gladys einen API-Schlüssel nur für die Überwachung an, zum Beispiel in Kibana → Dev Tools:
POST /_security/api_key{"name": "gladys", "role_descriptors": {"gladys": {"cluster": ["monitor"],"indices": [{"names": ["*"], "privileges": ["monitor"]}]}}}Kopiere den Wert
encodedin API-Schlüssel (Elasticsearch). Bei OpenSearch oder ohne API-Schlüssel lege einen Benutzer mit der Berechtigungcluster_monitoran (undindices_monitor, um rote Indizes zu nennen) und fülle Benutzer und Passwort aus. Nie das Kontoelasticoderadmin. -
Adresse: ein beliebiger Knoten, z. B.
192.168.1.20(Port 9200, erst HTTPS, dann HTTP) oderhttps://es.lan:9200. -
HTTPS mit selbstsigniertem Zertifikat (Standard bei Elasticsearch 8 und OpenSearch): Klicke auf Verbindung testen. Es zeigt den SHA-256-Fingerabdruck des Zertifikats. Prüfe, dass es der deines Clusters ist: Auf dem Server zeigt ihn
openssl s_client -connect localhost:9200 </dev/null | openssl x509 -noout -fingerprint -sha256an. Kopiere ihn dann in Zertifikat-Fingerabdruck und speichere. Dann wird nur dieses Zertifikat akzeptiert. Jedes Zertifikat akzeptieren überspringt jede Prüfung: besser nicht. -
Füge den Cluster und die gewünschten Knoten im Tab Entdecken hinzu.
Das Aktualisierungsintervall (standardmäßig 1 Minute) legt fest, wie oft der Cluster gelesen wird: jedes Mal fünf leichte Überwachungsanfragen (sechs, wenn er rot ist). Die Sprache der Namen legt die Namen der Funktionen fest, beim Hinzufügen eines Geräts fixiert, und die Texte für Szenen.
Aktionen
- Verbindung testen: liest den Cluster jetzt und sagt, was gefunden wurde (Produkt, Status, Knoten), mit dem Fingerabdruck eines HTTPS-Zertifikats.
Szenen
Auslöser, die ohne hinzugefügtes Gerät funktionieren:
- Cluster-Status ändert sich: der Status wird grün, gelb oder rot. Wähle den neuen Status oder lass das Feld leer für jede Änderung. Variablen: der Cluster, der neue und der vorherige Status, die nicht zugewiesenen Shards, die roten Indizes.
- Knoten-Platte fast voll: die Platte eines Knotens erreicht 80, 85, 90 oder 95 %. 85 % ist die untere Wassermarke von Elasticsearch (keine neuen Shards auf dem Knoten), 90 % die obere (Shards ziehen weg), 95 % die Flutmarke (seine Indizes werden schreibgeschützt). Erneut gemeldet, wenn die Platte 2 Punkte darunter war.
- Cluster nicht erreichbar: der Cluster antwortet nicht mehr, bei zwei Abfragen hintereinander (eine fehlgeschlagene Abfrage wird nach 20 Sekunden wiederholt). Variable: der Grund.
Aktion:
- Zustand des Clusters: liest den Cluster für die nächsten Aktionen: Status, Knoten, nicht zugewiesene Shards, Dokumente, vollste Platte und eine fertige Zusammenfassung für eine Nachricht („Cluster logs: gelb, 3 Knoten, 2 nicht zugewiesene Shards, Datenträger von es-1 87 % …“).
Dashboard
Das Widget Suchcluster zeigt den Status in seiner Farbe, die Knoten, die nicht zugewiesenen Shards, die Dokumente und die Größe der Indizes, dann die roten Indizes und eine Zeile pro Knoten (Platte und Heap, die vollste Platte zuerst, ★ für den gewählten Master). Seine Schaltfläche Aktualisieren liest den Cluster neu. Liste und Schaltfläche lassen sich in den Widget-Einstellungen ausblenden.
Grenzen
- Ein Cluster pro Installation der Integration.
- Getestet mit Elasticsearch 8 und OpenSearch 2; Elasticsearch 7 und OpenSearch 1 bieten dieselben APIs (ungetestet). Elastic Cloud geht auch
(API-Schlüssel,
https://…:443), die Integration ist aber für einen Cluster in deinem Netz gedacht. - Der Zustand der Indizes wird nicht Index für Index verfolgt: Nur die Namen der roten werden genannt.
Fehlerbehebung
- „Zertifikat nicht vertrauenswürdig“: siehe Schritt 3 der Konfiguration.
- „Zugriff verweigert“: Schlüssel oder Benutzer fehlt das Cluster-Recht
monitor. Nur mit dem Cluster-Zustand funktioniert das Cluster-Gerät trotzdem, ohne Knoten, Dokumente und Größe. - Die Details jeder Abfrage stehen in den Protokollen der Integration mit
LOG_LEVEL=debug.
Elasticsearch ist eine Marke von Elasticsearch B.V., OpenSearch von LF Projects, LLC. Diese Integration ist mit keiner von beiden verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt Elasticsearch / OpenSearch in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein Cluster | section | Nein | Nur lesend. Ist die Sicherheit aktiv, lege für Gladys einen API-Schlüssel (oder Benutzer) mit dem Cluster-Recht „monitor“ an. Füge dann Cluster und Knoten im Tab „Entdecken“ hinzu. |
| Adresse | string | Ja | Ein beliebiger Knoten des Clusters. Ohne http:// oder https:// wird HTTPS, dann HTTP versucht; Port 9200, sofern nicht angegeben. |
| API-Schlüssel (Elasticsearch) | secret | Nein | Empfohlen bei Elasticsearch: der Wert „encoded“ des Schlüssels. Leer: Benutzer und Passwort unten oder keine. |
| Benutzer (ohne Schlüssel) | string | Nein | |
| Passwort (ohne Schlüssel) | secret | Nein | Nie das Konto elastic oder admin: ein Benutzer nur für die Überwachung. |
| HTTPS-Zertifikat | section | Nein | Ein selbstsigniertes Zertifikat (Standard bei Elasticsearch 8 und OpenSearch) wird abgelehnt, bis du es bestätigst: „Verbindung testen“ zeigt seinen Fingerabdruck. |
| Zertifikat-Fingerabdruck | string | Nein | SHA-256, aus „Verbindung testen“ kopiert: Dann wird nur dieses Zertifikat akzeptiert. |
| Jedes Zertifikat akzeptieren (nicht empfohlen) | boolean | Nein | Keine Prüfung: Jeder im Netz könnte sich als Cluster ausgeben. Nimm lieber den Fingerabdruck. |
| Optionen | section | Nein | |
| Aktualisierungsintervall | select | Nein | Wie oft der Cluster gelesen wird: jedes Mal fünf leichte Überwachungsanfragen. |
| Sprache der Namen | select | Nein | Namen der Gerätefunktionen (beim Hinzufügen festgelegt) und Texte der Szenen. |
So installierst du Elasticsearch / OpenSearch in Gladys
- Öffne in Gladys Integrationen: Elasticsearch / OpenSearch erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-elasticsearch: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-elasticsearch.
Elasticsearch / OpenSearch 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
Elasticsearch / OpenSearch 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