Clawtronics: Status-Monitor aus dem aktuellen status-Modul dokumentiert

2026-08-06T20:57:53Z

Status-Monitor aus dem aktuellen status-Modul dokumentiert

Neue Seite

= Status-Monitor =

Der '''MegBes-Status-Monitor''' ist unter [https://status.megbes.de status.megbes.de] erreichbar. Technisch ist er eine eigenständig betriebene Spring-Boot-Anwendung, fachlich und im Quellcode aber Bestandteil des MegBes-Systems. Im Maven-Multi-Modul-Projekt wird er als Modul <code>status</code> gebaut; das Artefakt heißt <code>megbes-status</code>.

Der Status-Monitor ist eine interne Betriebs- und Administrationsoberfläche. Er gehört nicht zum Bedienweg der Besucher.

== Aufgabe im Gesamtsystem ==

Der Monitor führt die projektspezifischen Instanzen von <code>megbes-external</code> und <code>megbes-internal</code> paarweise zusammen und zeigt deren Erreichbarkeit an.

Status-Monitor → management/health von megbes-external
Status-Monitor → management/health von megbes-internal
Status-Monitor → optionale Integrationsaufrufe über megbes-external → megbes-internal

Die zu überwachenden External- und Internal-Adressen stammen aus der zentralen MegBes-Konfiguration. Der Monitor ersetzt weder die Projektseite im Wiki noch eine vollständige Funktionsprüfung der Medienstationen.

== Statusübersicht und Health-Checks ==

Für jedes konfigurierte Projekt zeigt die Startseite die External- und Internal-Seite nebeneinander an.

{| class="wikitable"
! Anzeige
! Bedeutung
|-
| <code>OK</code> || Der geschützte Aufruf von <code>/management/health</code> war erfolgreich.
|-
| <code>ERROR</code> || Der Health-Endpunkt konnte nicht erfolgreich aufgerufen werden; Ursache können Anwendung, Netzwerk, TLS, Konfiguration oder Berechtigung sein.
|-
| External-Details || Projektname, geprüfte URL, Mailsteuerung und gegebenenfalls Internal-Aufrufprotokolle sowie Integrationstest.
|-
| Internal-Details || Projektname, geprüfte URL und Mailsteuerung.
|}

Für die Management-Endpunkte setzt der Monitor einen konfigurierten Header samt Schlüssel. Diese Werte sind Geheimnisse und werden nicht im Wiki dokumentiert.

Beim External-Check wird zusätzlich <code>/management/info</code> gelesen. Liefert die Anwendung dort ihren Namen, kann der Monitor vorhandene Internal-Aufrufprotokolle zuordnen.

Die Statusdaten werden zwischengespeichert. Die Funktion „Neu laden“ leert den Cache und fragt die Zustände erneut ab. Ein grüner Health-Check bestätigt die Erreichbarkeit der Anwendung, aber nicht automatisch UDP-Empfang oder Reaktion einer Medienstation.

== E-Mail-Benachrichtigungen ==

Bei aktiviertem SSL-Betrieb prüft ein geplanter Lauf den Zustand stündlich. Für fehlerhafte Instanzen kann der Monitor E-Mails versenden. Im aktuellen Quellstand wird bei einem fortbestehenden Fehler höchstens bei den ersten fünf Prüfläufen benachrichtigt. Ist wieder alles fehlerfrei, wird der Fehlerzähler zurückgesetzt.

Die Benachrichtigung kann je überwachter URL in der Oberfläche aktiviert oder deaktiviert werden. Eine Deaktivierung soll nur mit dokumentiertem Grund und vorgesehener Reaktivierung erfolgen.

== Internal-Aufrufprotokolle ==

Wenn für eine External-Anwendung entsprechende Datensätze vorhanden sind, zeigt der Monitor die zuletzt gespeicherten Aufrufe an. Die Ansicht ist auf die jüngsten 100 Einträge begrenzt und absteigend nach Zeitpunkt sortiert.

Diese Protokolle helfen bei der Frage, ob und wann <code>megbes-external</code> die interne Seite aufgerufen hat. Sie ersetzen nicht das Anwendungslog von <code>megbes-internal</code> und bestätigen noch keine Reaktion des UDP-Endgeräts.

== Manueller Integrationstest ==

Der Monitor kann je Projekt einen funktionalen Test mit oder ohne Authentifizierung ausführen.

=== Projekt mit Authentifizierung ===

Der aktuelle Test durchläuft:

# administrative Anmeldung über <code>/authenticate</code>
# Prüfung über <code>/verify-admin</code>
# Erzeugung eines temporären Tickets über <code>/ticket</code>
# Aktivierung über <code>/enter-system</code>
# Benutzerprüfung über <code>/verify</code>
# Stationsanmeldung über <code>/media-station</code>
# optional einen Befehl über <code>/video-command</code>
# Stationsabmeldung über <code>DELETE /media-station</code>

=== Projekt ohne Authentifizierung ===

Ohne aktivierte MegBes-Sicherheit besteht der Funktionstest im aktuellen Stand nur aus dem optionalen Aufruf von <code>/video-command</code>.

<div style="border:2px solid #b32424; padding:0.8em; margin:1em 0; background:#fff3f3;">
'''Achtung: Der Integrationstest kann eine reale Station steuern.''' Ist „Kommunikation zum internen MegBes-Server ebenfalls abtesten“ aktiviert, sendet der aktuelle Quellstand den Befehl <code>120-start</code>. Vor dem Test muss geprüft werden, was Station 120 im betreffenden Projekt ist und welche Wirkung <code>start</code> dort hat. Der Test darf nicht unkontrolliert im laufenden Ausstellungsbetrieb ausgeführt werden.
</div>

Ein erfolgreicher Integrationstest bestätigt abhängig von der gewählten Option den HTTP-Ablauf bis <code>megbes-external</code> beziehungsweise bis zur Übergabe an <code>megbes-internal</code>. Empfang und Ausführung des UDP-Befehls am Endgerät müssen separat kontrolliert werden.

== Zertifikatsverwaltung ==

Der Status-Monitor verwaltet die Client-Zertifikate für geschützte Verbindungen zu <code>megbes-internal</code>. Die Oberfläche kann projektspezifische Zertifikate:

* anzeigen,
* erstellen,
* als Paket beziehungsweise Keystore herunterladen,
* Installationshinweise anzeigen und
* löschen.

Die Metadaten werden persistent gespeichert; die erzeugten Dateien liegen in der konfigurierten Zertifikatsablage. Neue Zertifikate werden über das mitgelieferte OpenSSL-Skript erzeugt. Einzelheiten und Sicherheitsregeln stehen unter [[Zertifikate]].

'''Löschen ist eine betriebswirksame und potenziell destruktive Aktion.''' Vorher müssen Projektzuordnung, verwendete Dateien, Rückkehrweg und betroffene Container geprüft werden. Passwörter, private Schlüssel und Zertifikatsdateien gehören nicht ins Wiki.

== Passwortwerkzeug ==

Die Oberfläche enthält ein Hilfswerkzeug zum Ver- und Entschlüsseln von Konfigurationswerten mit der gemeinsamen MegBes-Kryptofunktion. Die Klartext- oder Chiffrewerte dürfen weder in Tickets noch ins Wiki oder in ungeschützte Zwischenablagen übernommen werden.

== Zugriffsschutz ==

Der gesamte Status-Monitor ist mit Ausnahme der Loginseite und ihrer unmittelbar benötigten Gestaltungselemente anmeldungspflichtig. Der aktuelle Stand verwendet einen konfigurierten Benutzer mit BCrypt-geprüftem Passwort im Arbeitsspeicher der Anwendung.

Trotz Login ist die Oberfläche hochprivilegiert: Sie kann Integrationstests auslösen, Mailbenachrichtigungen verändern, Geheimwerte verarbeiten und Zertifikate erstellen oder löschen. Daher gelten mindestens:

* ausschließlich HTTPS verwenden,
* Zugang nur an berechtigte Betriebsverantwortliche vergeben,
* Zugangsdaten nicht gemeinsam oder im Wiki speichern,
* Sitzung nach der Arbeit beenden,
* Änderungen und Tests projektbezogen dokumentieren,
* öffentliches Caching von Administrationsseiten auf Proxy-Ebene verhindern.

== Diagnose mit dem Status-Monitor ==

{| class="wikitable"
! Beobachtung
! Nächster Schritt
|-
| External und Internal beide <code>ERROR</code> || zentrale Erreichbarkeit, DNS, Monitor-Konfiguration und Zertifikate prüfen.
|-
| External <code>OK</code>, Internal <code>ERROR</code> || lokale Erreichbarkeit, DynDNS/Router, TLS-Zertifikat und <code>megbes-internal</code> prüfen.
|-
| beide <code>OK</code>, Bedienbefehl ohne Wirkung || Integrationstest kontrolliert ausführen, danach Internal-Log, UDP-Weg und Station prüfen.
|-
| Internal-Aufruf ist protokolliert, Station reagiert nicht || <code>megbes-internal</code>-Log, Zieladresse, UDP-Port und Stationssoftware prüfen.
|-
| Health-Anzeige wirkt veraltet || „Neu laden“ verwenden und anschließend die Komponentenlogs vergleichen.
|}

== Grenzen und Dokumentationspflicht ==

Der Status-Monitor zeigt Laufzeitinformationen, jedoch keinen vollständigen dauerhaften Anlagenstand. Auf der jeweiligen [[Projektübersicht|Projektseite]] bleiben mindestens Release, Domains, interne Erreichbarkeit, Zertifikatszuordnung, Betriebsart und Ergebnis relevanter Tests zu dokumentieren.

Quellcodebasis dieser Beschreibung ist das Modul <code>status</code> des aktuellen MegBes-Repositorys. Bei einem abweichenden installierten Release hat dessen tatsächliches Verhalten Vorrang.

Siehe auch [[Wartung, Backups und Fehlerdiagnose]], [[Routing und Signalweg]], [[Zertifikate]], [[Softwaremodule]], [[Client-Feedback und Stationsmeldungen]] und [[Stationsseitige Diagnose]].

[[Kategorie:MegBes]]
[[Kategorie:Betrieb]]
[[Kategorie:Monitoring]]
[[Kategorie:Status-Monitor]]

Status-Monitor - Versionsgeschichte

Clawtronics: Status-Monitor aus dem aktuellen status-Modul dokumentiert