Status-Bot: Unterschied zwischen den Versionen

Aus LaborWiki
Wechseln zu: Navigation, Suche
Keine Bearbeitungszusammenfassung
 
(20 dazwischenliegende Versionen von 11 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
{{ProjektInfoBox
{{ProjektInfoBox
|name       = Labor Status-Bot
|name=Labor Status-Bot
|status     = stable
|status=stable
|image       =  
|image=StatusON.png
|description = Zeigt den aktuellen Labor Status an
|description=Zeigt den aktuellen Labor Status an
|author      = Til
|username=Asklepios
|username    = Til
|author=Asklepios
|version     =
|version=0.5.0
|update      =  
|platform=Labor/python/xmpp
|platform   = Labor/ruby/xmpp4r
|license=GPL v3+
|license     =  
|download=https://www.das-labor.org/svn/tools/statusbot
|download   =  
|tags=Software,
}}
}}
'''[https://das-labor.org/status Zum Statusbot]'''


==LABOR-Status==
Es ist unbequem, immer im LABOR anrufen zu müssen, um herauszufinden, ob gerade jemand da ist, ob man 'reinkommt oder ob man, wenn man denn mal drin wäre, alleine verpeilen müsste.
===Legende===
 
Auch interesannt: die Heatmap des Statusbots, [https://mapall.space/heatmap//show.php?id=Das+Labor hier] finden sich grobe infos darüber wann das Labor in der Vergangenheit immer so offen war.
 
Die Information '''"LABOR offen/zu"''' wird also durch das Betätigen des Hauptstromschalters am Eingang verändert und schließlich auf der Startseite und unter '''[https://das-labor.org/status /status]''' angezeigt.
 
<!--
<big>'''<font color="red">Derzeit ist der Status-Bot defekt. Bitte ruft kurz durch im Labor, um zu überprüfen, ob jemand vor Ort ist!</font>'''</big> [[Kontakt|(Kontakt)]]
-->
==Legende==
* [[Bild:StatusON.png]] das LABOR ist geöffnet
* [[Bild:StatusON.png]] das LABOR ist geöffnet


Zeile 21: Zeile 30:
* [[Bild:StatusOFF.png]] das LABOR ist geschlossen
* [[Bild:StatusOFF.png]] das LABOR ist geschlossen


==Services==


===Motivation===
===HTTP===
 
Es ist unbequem, immer im LABOR anrufen zu müssen, um herauszufinden, ob gerade jemand da ist, ob man 'reinkommt oder ob man, wenn man denn mal drin wäre, alleine verpeilen müsste. Die Information "LABOR offen | LABOR zu" sollte also irgendwie anderes transportiert werden.
 
 
===Services===
 
'''HTTP'''
 
Zu diesem Zweck stellt der Bot unter http://www.das-labor.org/status.png den aktuellen Status dar. Dieses Icon ist auch auf www.das-labor.org zu sehen und kann und darf auch auf anderen Webseiten verlinkt werden.


Zu diesem Zweck stellt der Bot unter http://www.das-labor.org/status/LAB_STATE.png den aktuellen Status dar. Dieses Icon ist auch auf www.das-labor.org zu sehen und kann und darf auch auf anderen Webseiten verlinkt werden.


'''XMPP'''
http://das-labor.org/status/status.php?status


Desweiteren ist der Öffnungsstatus des LABORs auch via [http://de.wikipedia.org/wiki/Jabber Jabber] zu erfahren. Dazu fügt man "status bei das-labor pünkt org" der eigenen Kontaktliste hinzu. Der Bot zeigt hier durch seinen Status an, wie der des LABORs gerade ist (free for chat = offen, Extended Away/Not Available = geschlossen, DND = habe keine Daten)
===Spaceapi===
Endpunkt: https://das-labor.org/status/api


===Wie funktionierts?===
Infos: https://spaceapi.io
Der Bot besteht aus Client und Server, die via [http://de.wikipedia.org/wiki/XMPP XMPP] (also über einen Jabberserver) kommunizieren.


==Wie funktionierts?==
DIESE INFORMATIONENSIND NICHT MEHR AKTUELL
TODO: Überarbeitung notwendig


'''Server'''
===Server===


Auf dem Server, der auch die Webseiten des LABORs vorhält, läuft auch der Server des Statusbots. Er lauscht unter der Adresse status ät das minus labor pünkt org auf Statusinformationen seitens des Clients und schreibt abhängig davon ein farblich passendes Statusicon in das document-root der Domain www.das-labor.org. Dabei setzt er gleichzeitig entsprechend seinen im Jabber sichtbaren Status.
Auf dem Server, der auch die Webseiten des LABORs vorhält, läuft auch der Server des Statusbots. Er lauscht unter der Adresse status ät das minus labor pünkt org auf Statusinformationen seitens des Clients und schreibt abhängig davon ein farblich passendes Statusicon in das document-root der Domain www.das-labor.org. Dabei setzt er gleichzeitig entsprechend seinen im Jabber sichtbaren Status.
Er validiert, dass die Statusmeldungen des Clients von dem dazu berechtigten Account kommen, was dank des Designs des Extensible Messaging and Presence Protocol auch zumindest nicht trivial zu umgehen ist.
Er validiert, dass die Statusmeldungen des Clients von dem dazu berechtigten Account kommen, was dank des Designs des Extensible Messaging and Presence Protocol auch zumindest nicht trivial zu umgehen ist.
Wenn der Server für eine definierte Zeit keine Statusinformationen mehr vom Client empfangen hat, setzt er den Status auf NONE, das Icon wird gelb, der Jabberstatus DND.
Wenn der Server für eine definierte Zeit keine Statusinformationen mehr vom Client empfangen hat, setzt er den Status auf NONE, das Icon wird gelb.




'''Client'''
===Client===


Der Client läuft im LABOR auf roulette. Er ruft in einem definierten Interval (z.Zt. 30s) das script
Der Client läuft im LABOR auf ''weblab (wl)''.  
/etc/statusclient/status.sh
''/etc/init.d/status-setter'' startet ''/usr/local/sbin/endlessloop.sh'' welches in einem definierten Interval (z.Zt. 60s) das Skript ''/usr/local/sbin/mysetter.py''
auf. In Abhaengigkeit des Ruegabewertes (0 = labor offen | 1 = labor zu) wird der Status ueber den client gesetzt. Der Client ist ein permanent online erreichbarer Jabberclient (statsetter at das-labor (subdomaindelimiter here)/status). Dieses Script ist im moment so aufgebaut, dass versucht wird unseren Druckerserver Blackjack zu pingen. Dabei wird Blackjack eigentlich nur mit dem Hauptschlater ein und aus geschaltet - kommt einer auf die Idee blackjack auszuschalten, oder vom labornetz zu trennen wird also der Status des Labors auf "geschlossen" gesetzt.  
aufruft. Dieses testet die den Status mit einem Ping an ''blackjack'' und sendet dann ein entsprechendes Kommando an den Server.


[[category:Automatisierung]]
[[category:Automatisierung]]

Aktuelle Version vom 6. April 2022, 12:32 Uhr

           
Labor Status-Bot

Release status: stable [box doku]

StatusON.png
Description Zeigt den aktuellen Labor Status an
Author(s)  Asklepios
Last Version  0.5.0 ()
Platform  Labor/python/xmpp
License  GPL v3+
Download  https://www.das-labor.org/svn/tools/statusbot



Zum Statusbot

Es ist unbequem, immer im LABOR anrufen zu müssen, um herauszufinden, ob gerade jemand da ist, ob man 'reinkommt oder ob man, wenn man denn mal drin wäre, alleine verpeilen müsste.

Auch interesannt: die Heatmap des Statusbots, hier finden sich grobe infos darüber wann das Labor in der Vergangenheit immer so offen war.

Die Information "LABOR offen/zu" wird also durch das Betätigen des Hauptstromschalters am Eingang verändert und schließlich auf der Startseite und unter /status angezeigt.

Legende[Bearbeiten | Quelltext bearbeiten]

  • StatusON.png das LABOR ist geöffnet
  • StatusNONE.png Der Statusbot erhält gerade keine Daten und weiss nicht, ob das LABOR geöffnet oder geschlossen ist. Ruf am besten an und finde es selbst heraus.
  • StatusOFF.png das LABOR ist geschlossen

Services[Bearbeiten | Quelltext bearbeiten]

HTTP[Bearbeiten | Quelltext bearbeiten]

Zu diesem Zweck stellt der Bot unter http://www.das-labor.org/status/LAB_STATE.png den aktuellen Status dar. Dieses Icon ist auch auf www.das-labor.org zu sehen und kann und darf auch auf anderen Webseiten verlinkt werden.

http://das-labor.org/status/status.php?status

Spaceapi[Bearbeiten | Quelltext bearbeiten]

Endpunkt: https://das-labor.org/status/api

Infos: https://spaceapi.io

Wie funktionierts?[Bearbeiten | Quelltext bearbeiten]

DIESE INFORMATIONENSIND NICHT MEHR AKTUELL TODO: Überarbeitung notwendig

Server[Bearbeiten | Quelltext bearbeiten]

Auf dem Server, der auch die Webseiten des LABORs vorhält, läuft auch der Server des Statusbots. Er lauscht unter der Adresse status ät das minus labor pünkt org auf Statusinformationen seitens des Clients und schreibt abhängig davon ein farblich passendes Statusicon in das document-root der Domain www.das-labor.org. Dabei setzt er gleichzeitig entsprechend seinen im Jabber sichtbaren Status. Er validiert, dass die Statusmeldungen des Clients von dem dazu berechtigten Account kommen, was dank des Designs des Extensible Messaging and Presence Protocol auch zumindest nicht trivial zu umgehen ist. Wenn der Server für eine definierte Zeit keine Statusinformationen mehr vom Client empfangen hat, setzt er den Status auf NONE, das Icon wird gelb.


Client[Bearbeiten | Quelltext bearbeiten]

Der Client läuft im LABOR auf weblab (wl). /etc/init.d/status-setter startet /usr/local/sbin/endlessloop.sh welches in einem definierten Interval (z.Zt. 60s) das Skript /usr/local/sbin/mysetter.py aufruft. Dieses testet die den Status mit einem Ping an blackjack und sendet dann ein entsprechendes Kommando an den Server.