Plugin: Message Center

[r.marske]

Ich hab mal wieder ein neues Plugin geschrieben, welches die Systemmeldungen vom Loxone Miniserver ausliest und diese via Virtuelle Eingänge wieder zurückspielt um damit Schaltungen zu realisieren.

https://wiki.loxberry.de/plugins/message_center/start

Ihr könnt dann entsprechend auf die verschiedenen Warnstufen reagieren und ggf. eine Lampe rot leuchten lassen oder ein TTS ausgeben lassen.
Die Möglichkeiten sind schier endlos.

Eine Systemmeldung kann folgendes sein:
* Neustart des Systems
* Ein überwachtes Gerät is offline
* Ein Sensor liefert falsche Werte.

https://www.loxone.com/dede/kb/systemstatus/

Viel Spass mit dem Plugin.


Liebe Grüße
Ronald

[Prof.Mobilux]

Cool. Wo greifst Du die Meldungen ab? Musst Du dazu das Log auslesen oder gibt's die "irgendwo" am MS?

Der Hammer für mich wäre, wenn man die Meldungen automatisch quittieren könnte : Mich nerven die Dinger ungemein ("Großer Temperaturunterschied zwischen.... blah blah blah"), aber das geht wohl nicht, oder?

[Gagi]

Über WebSockets lässt sich das bestimmt auch quitieren. Man müsste sich mal anschauen was die App da genau macht. Aber Ronald ist bestimmt schon drann ;-)

[r.marske]

Das ist ne standard HTTP API, die Meldungen kommen eh verzögert weswegen das nicht so tragisch ist die kontinuierlich abzufragen.

siehe: https://github.com/LoxYourLife/messa...n/index.js#L41

Die Idee mit dem automatischen quittieren finde ich ehrlich gesagt ziemlich nice.
Soweit ich gesehen habe ist in der API auch ein Actions part drin, das steckt das sicher drin.

[Curiosity]

[…] Der Hammer für mich wäre, wenn man die Meldungen automatisch quittieren könnte : Mich nerven die Dinger ungemein ("Großer Temperaturunterschied zwischen.... blah blah blah")

Oja, das wäre echt klasse wenn das gehen würde. Hat mich diesen Sommer richtig genervt und jetzt wo es gerade wieder milder draußen ist, kommt die Meldung auch wieder.

[Prof.Mobilux]

Ja, das wäre dann wieder ein nerviges BlinkiBlinki-Icon weniger, wo Loxone uns verweigert selbst zu entscheiden, was wir sehen wollen und was nicht.

[r.marske]

Also, die Nachrichten werden per Websocket als gelesen markiert und auch quittiert. Gleiches geht auch über HTTP.

Die Frage die sich mit stellt ist wie man die Quittierung am sinnvollsten implementiert. Ich würde ungern komplexe Logik ins plugin packen.
Es gibt mehrere Aktionen:
* Als gelesen markieren (dann verschwindet die Meldung in der App und das Plugin liefert die werte auch nicht mehr an den MS)
* Bestätigen (setzt dann einfach nur "confirmed at")

Sinnvoll fände ich es dem Miniserver die Entscheidung zu überlassen, was er quittieren möchte und was nicht. Es möchte eh jeder anders implementiert haben.

Als gelesen markieren: GET http://<MS-IP>/jdev/sps/io/<message-center-id>/readEntry/<entry-id>
Bestätigen: GET http://<MS-IP>/jdev/sps/io/<message-center-id>/action/<entry-id>/1005 (1005 ist die action id, da gibts es auch mehrere)

Um das zu realisieren müsste das Plugin die message-center-id sowie die entry-id liefern und zusätzlich würde ich noch "hasConfirmAction" einbauen sofern diese vorhanden ist. ich glaube nämlich dass die nicht immer da ist.

Wenn die beiden Felder da sind, schickt der MS sich selber einfach nachrichten und die messages sind weg. Push Mitteilungen kommen aber bestimmt trotzdem.

Liebe Grüße

[Prof.Mobilux]

Also, die Nachrichten werden per Websocket als gelesen markiert und auch quittiert. Gleiches geht auch über HTTP.

You made my day!

So wie Du es beschrieben hast finde ich es am Besten - also jeder entscheidet in seiner Logik selbst, ob er quitieren will oder eben nicht. Vielleicht die anderen beiden Optionen als "Default-Schalter" im Plugin, falls jemand wirklich alles abschalten will.

[r.marske]

Gerne
Leider ist es doch nicht so einfach wie ich dachte, weil der MS nicht mehrere Werte an einen HTTP Ausgang setzten kann. Das nervt mich jetzt schon wieder.

Da müsste das dann doch über das Plugin laufen.

[orli]

Mich nerven die Dinger ungemein ("Großer Temperaturunterschied zwischen.... blah blah blah"), aber das geht wohl nicht, oder?

Michael, gerade diese Meldungen kann man seit einer der letzen Versionen direkt im IRR deaktivieren:



Sehr cooles Plugin, direkt mal installiert.

[Prof.Mobilux]

"Einer der letzten Versionen" kommt mir garantiert nicht auf den MS 😉

[r.marske]

Version 0.0.2 ist released, man kann jetzt die Meldungen automatisch lesen und Bestätigen

https://github.com/LoxYourLife/message-center/releases/tag/0.0.2

[Prof.Mobilux]

Hallo Ronald,

Danke Dir!

Wie mache ich das in der Praxis? Ich checke "MessageCenter_message_entryUuid" auf Änderungen (s. B. so: https://loxwiki.atlassian.net/wiki/s...ertes+erkennen) und schicke die empfangene Uuid dann an den Endpoint

http://[loxberry-ip]/admin/express/plugins/message_center/message/mark-as-read/[enteryUuid]

zurück?

[r.marske]

Hey Michael,

theoretisch kannst du das so machen, aber ich würde das nicht generalisieren. In dem Fall würdest du jede Meldung quittieren und ich glaube, das willst du nicht. Das Plugin schickt leere werte, wenn eine Meldung als gelesen markiert ist, also reicht dir tendenziell ein Status Baustein aus.

Für meine Demo hab ich folgendes gemacht:
Status Baustein 1: Name "Miniserver Status"
I1: MessageCenter_message_severity
I2: MessageCenter_message_desc

Einstellungen:
I1 = 0, text: Alles Okay - keine Meldung
I1 = 1, text: Info: <v2>
I1 = 2, text: Warnung: <v2>
I1 = 3, text: Fehler: <v2>

Hab natürlich noch Farben und Symbole ausgewählt dazu, aber das ist nicht so wichtig. Taucht nun eine Meldung auf, dann kann ich diese im Status baustein anzeigen lassen, lese ich sie springt der Baustein zurück auf "Alles Okay".

Für das quittieren habe ich 2 weitere Status Bausteine:
Status Baustein 2: Name "Automatisch quittieren"
I1: MessageCenter_message_severity
I2: MessageCenter_message_affectedName
I3: MessageCenter_message_entryUuid

Einstellungen:
I1 == 3 && I2 == "Loxone Music Server 'Alexa Music Loxberry'" -> Statustext=<v3> Statuswert=1
Am Ausgang TXT hänge jetzt der Virtuelle Ausgang: "Read Message" der automatisch die entryUuid bekommt und abschickt Sobald es gelesen wurde ist der Statustext wieder leer - es geht zwar ein neuer Http Request raus, der macht aber nix.

Für Automatisch Bestätigen alles wie bei Automatisch quittieren + I4: MessageCenter_message_hasConfirmAction
Einstellungen:
I1 == 3 && I2 == "Loxone Music Server 'Alexa Music Loxberry'" && I4 == 1 -> Statustext=<v3> Statuswert=1
Am Ausgang Txt hängt dann "Confirm Message".

So kannst du auf die jeweiligen Meldungen individuell reagieren und ggf auch andere Aktionen auslösen.

Ich hoffe das hilft dir.

LG
Ronald

[Prof.Mobilux]

Passt - Danke! Irgendetwas haut mit dem Plugin noch nicht hin. Ich bekomme folgende Meldung beim Aufruf der Oberfläche:



Express Server läuft. Bei der Installation kamen aber auch Fehlermeldungen (die LoxBerry Error-Seite aus dem Apache). Log hab ich angehängt.

[r.marske]

Also das ist in der Tat sehr merkwürdig.In dem Bild ist ein Übersetzungs Fehler, es müsste eigentlich heißen "Dieses Plugin benötigt den Express Server > 1.0.1 und < 3.0.0 ....". Da scheint irgendwas bei der Abfrage der Version nicht zu funktionieren, dass du diese Meldung bekommst: https://github.com/LoxYourLife/messa...auth/index.cgi

Welche Version hast du denn installiert vom Express Server?

Im Install log funktioniert der registration call an den express server nicht was dafür spricht, dass zum Zeitpunkt der installation der express server nicht erreichbar war oder der Endpunkt einfach nicht vorhanden ist. "POST http://<loxberry-ip>/admin/express/system/plugin/message_center"

Während ich auf der Suche des Fehlers war, schrieb einer in meiner Community und berichtete vom Selben Fehler -> Es scheint, als wenn die Express Server Version zu gering ist das Plugin braucht mindestens 1.0.0, besser noch 1.0.3 oder wenn du LB 3 laufen hast 2.0.0
Loxberry 2: https://github.com/LoxYourLife/loxbe...s/1.0.2-rc.zip
Loxberry 3: https://github.com/LoxYourLife/loxbe...tags/2.0.0.zip

Das hatte ich im Wiki noch nicht angepasst - definitiv mein Fehler.

[Prof.Mobilux]

Alles klar - Ich hab den Link aus dem Wiki genommen. Dann liegt es daran - ist noch Version 0.0.3. Ich installiere heute Abend mal direkt die neue Version. Die Meldung oben müsstest du vielleicht auch noch einmal anpassen. Da müsste doch eigentlich stehen: "Dieses Plugin benötigt das Express Server Plugin...", oder?

[r.marske]

Die Meldung habe ich lokal schon angepasst, muss das nur noch ins Git puschen und die version neu generieren.

Den Wiki Eintrag für Express hab ich auch schon angepasst.

[Prof.Mobilux]

Mit ExpressServer 1.0.2 läuft es nun. Er scheint auch die Meldungen laut Log vom Miniserver zu bekommen, aber im Broker sehe ich das Topic nicht. Broker läuft auf dem gleichen LoxBerry wie das Plugin:

2023-01-03T05:51:22: Config got changed - load new config
2023-01-03T05:51:22: Config got changed - load new config
2023-01-03T05:51:26: New system message on miniserver. sending to topic MessageCenter/message: {
2023-01-03T05:51:26: entryUuid: '1a39bc34-038a-34ae-ffff504f94a00fb9',
2023-01-03T05:51:26: affectedName: 'Übersicht',
2023-01-03T05:51:26: title: 'Onlinestatus unüberwacht',
2023-01-03T05:51:26: desc: 'Der Onlinestatus von Geräten folgender Typen wird aktuell nicht überwacht:
- Loxone Music Server

Dadurch erhalten Sie keine Benachrichtigung, wenn eines dieser Geräte nicht mehr erreichbar ist und Ihr automatisiertes Gebäude dadurch nicht mehr wie erwartet funktioniert. Die Onlinestatus-Überwachung können Sie in den Eigenschaften jedes Geräts individuell aktivieren.',
2023-01-03T05:51:26: severity: 2,
2023-01-03T05:51:26: hasConfirmAction: false
2023-01-03T05:51:26: }​

[r.marske]

Dennoch gibt's beim ersten senden von Daten eine Race Condition mit der Subscription für MQTT.
Neustarten im Message Center Plugin löst das Problem erstmal.

Werde mir das mal anschauen und einen delay für das erste starten einbauen.

[Christian Fenzl]

Macht du Publish oder mit Retain-Flag? Mit Retain kämen die Nachrichten auch rein, wenn die Subscription später dazu kommt.

[r.marske]

Danke für den Tipp, aktuell mach ich nur publish. Ich teste das gleich mal.