System
Inhaltsverzeichnis
- Übersicht
- Bildschirmstruktur — System-Gruppe
- Monitoring-Bildschirm (
/monitoring/index) - Log-Bildschirm (
/log/index) - Konfigurations-Bildschirm (
/config/index) - Umgebungsinformations-Bildschirm (
/env/view) - Anwendungsszenarien
- Häufig gestellte Fragen
- Verwandte Bildschirme
Übersicht
Das System-Menü ist der Bereich, in dem der Betriebszustand der Platform, Sicherheitskonten, Konfigurationen, Logs, Umgebungsinformationen und Cluster zusammengefasst sind. Die System-Gruppe im linken Menü enthält derzeit die folgenden Punkte.
| Untermenü | Interne URL / Externer Port | Zweck |
|---|---|---|
| Benutzer | /user/index | Verwaltung von Benutzerkonten |
| Sicherheitsrichtlinien | /security/index | Richtlinien für Passwörter und Zugriffssicherheit |
| API-Token | /token/index | API-Token für externe Anbindungen |
| Monitoring | /monitoring/index | Echtzeit-Dashboard für Infra-Health, Datenpipeline und Engine-Metriken |
| Diagnose | /diagnostic/index | Abfrage von Systemdiagnose-Events |
| Logs | /log/index | Chronologische Abfrage von Server-Applikationslogs (auf Klassen-, Methoden- und Zeilenebene) |
| Konfiguration | /config/index | Verwaltung von System Key-Value-Einstellungen (Neuerfassung/Neustart) |
| Umgebungsinformationen | /env/view | Abfrage von Konfigurationswerten pro Property-Datei in Tabs |
| Cluster | /cluster/index | Zustand der Cluster-Nodes |
| HA | /ha/index | Zustand der Hochverfügbarkeitskonfiguration |
| Audit | /audit/index | Audit-Logs |
Dieses Dokument konzentriert sich auf Monitoring / Logs / Konfiguration / Umgebungsinformationen. Für Benutzer, Sicherheit und Token beachten Sie bitte die Sicherheitsverwaltung, für Diagnose die Diagnose und für externe Werkzeuge die Standards und externe Werkzeuge.
Bildschirmstruktur — System-Gruppe
| Bildschirm | Hauptbenutzer | Zusammenfassung |
|---|---|---|
| Monitoring | Systemadministrator | Infra-Health 5 Felder + Pipeline-Diagramm + Engine-Metriken 9 Panels + Traffic, Cluster, Diagnose |
| Diagnose | Operator/Administrator | Systemdiagnose-Events und INFO/WARN/ERROR-Flüsse |
| Logs | Operator/Administrator | Detaillierte Applikationslogs inklusive Klassen-, Methoden- und Zeileninformationen |
| Konfiguration | Systemadministrator | Hinzufügen, Bearbeiten und Cache-Neuerfassung von System Key-Value-Einstellungen |
| Umgebungsinformationen | Systemadministrator | Abfrage von Property-Dateien (Engine/Applikation/Message-Queue/Storage/Mail/WebSocket) (Nur Lesen) |
| Cluster | Systemadministrator | Cluster-Nodes, Modus, Latenz, Ressourcenzustand |
| HA | Systemadministrator | Zustand der Hochverfügbarkeitskonfiguration |
| Audit | Systemadministrator | Audit-Logs |
Monitoring-Bildschirm (/monitoring/index)
Hier werden die Echtzeit-Betriebsmetriken der Platform in Form eines Dashboards angezeigt. Im Untertitel erscheint die Zeit des Serverstarts — so lässt sich auf einen Blick erkennen, ob ein Neustart gerade erst erfolgt ist.
| Nummer | Position | Inhalt |
|---|---|---|
| ① | Oben links | Infra-Health — 5 Felder |
| ② | Mitte links | Datenpipeline-Diagramm |
| ③ | Unten links | Engine-Metriken 9 Panels |
| ④ | Oben rechts | Datentraffic — Byte pro Sekunde + Sparkline |
| ⑤ | Mitte rechts | Cluster — Zustand pro Node, Lese-/Schreiblatenz, Storage |
| ⑥ | Unten rechts | Systemdiagnose — Health-Timeline + Aktuelle Diagnosen |
① Infra-Health — 5 Felder
| Feld | Label |
|---|---|
| 1 | Cache |
| 2 | MQTT |
| 3 | KAFKA |
| 4 | Event Store |
| 5 | Zeitreihen-Engine |
In jedem Feld wird «Normal» oder «Anomalie» angezeigt. Wenn alle Felder normal sind, ist der Betrieb stabil.
Die Untertitel-Phrase listet sechs Elemente auf: 「Cache, WebSocket, MQTT, Kafka, Event Store, Zeitreihen-Engine」, aber es werden tatsächlich nur fünf Felder gezeichnet. WebSocket/STOMP wurde im Juli 2026 außer Betrieb genommen (Browser-Push wurde durch SSE ersetzt). Zuerst wurde das Feld entfernt — im Untertitel ist es ein Überbleibsel.
② Datenpipeline-Diagramm
Das Diagramm ist in fünf Stufen unterteilt: Datenquelle → Message Bus → Engine → Analyse → Storage. Die Nodes sind in diesen Stufen angeordnet und durch Linien verbunden, die den tatsächlichen Pfluss darstellen.
| Stufe | Beispiel-Nodes |
|---|---|
| Datenquelle | Edge/Datei/API · DB · Modbus · PLC · OPC — an jedem Node die Anzahl der Registrierungen |
| Message Bus | Messaging-Hub — MSG/S |
| Engine | Pipeline (Bearbeitungszahl, Warteschlange) · CEP (Task-Anzahl) · Ingestion |
| Analyse | Scheduler · Batch · Stream (MPS) |
| Storage | Cache · Event Store · TSE (WPS) |
Die kleine Schrift unter einem Node zeigt dessen aktuelle Metrik. Suchen Sie hier zuerst, wenn Sie Engpässe finden wollen — wenn die Zahlen in einer vorderen Stufe steigen, aber in der folgenden Stufe stagnieren, liegt dort der Flaschenhals.
③ Engine-Metriken — 9 Panels
Aufbau in 3 Spalten × 3 Zeilen. Jedes Panel besteht aus einigen Key-Value-Zeilen und einem kleinen Diagramm.
| Panel | Angezeigter Wert |
|---|---|
| PPS | Aktuelles PPS · Max PPS (Erfassung pro Sekunde, letzte 1 Min) |
| JVM Heap | Belegt · Gesamt |
| Pipeline | Bearbeitungsabschluss · Warteschlange |
| Storage | Pufferwarteschlange · Aktiver Batch |
| Messaging | KAFKA · MQTT |
| Streaming | Bearbeitungsanzahl · Timeout |
| Async Executor | Aktiv · Wartend |
| Diagnose | Warnung · Kritisch |
| Cache | HIT · MISS |
④ Datentraffic
Zeigt die Byte pro Sekunde als große Zahl an, ergänzt durch eine Sparkline darunter.
⑤ Cluster
| Spalte | Anzeige |
|---|---|
| Zustand | Node-Zustandsindikator |
| Node IP | |
| Lesen | Lese | Schreiblatenz (ops/s) |
| Storage | Vom Node beschriebene Kapazität |
Oben steht Gesamtcluster N Nodes, unten die Zeit der letzten Aktualisierung.
⑥ Systemdiagnose
Kombiniert eine Health-Timeline (Legende: Normal, Info, Warnung, Kritisch) mit einer Liste der aktuellen Diagnosen. Jede Zeile enthält den Zeitpunkt des Auftretens, die relative Zeit und ein Quellen-Badge (SERVER / EDGE), sodass sofort ersichtlich ist, ob der Event von der Platform oder von einer Edge vor Ort stammt. Detaillierte Abfragen erfolgen im Diagnose-Bildschirm.
In früheren Versionen gab es hier eine Verbindungs-Heatmap mit farbigen Blöcken pro Datenquelle. Diese wird nicht mehr gezeichnet (nur noch Textreste vorhanden). Um den Status der Verbindungen in einer Matrix zu sehen, nutzen Sie das Raster der Datenquellen-Karten im Verbindungsstatus-Bildschirm.
Log-Bildschirm (/log/index)
Hier werden die Logs der Server-Applikation auf Code-Ebene (Klasse, Methode, Zeile) chronologisch abgefragt. Im Gegensatz zu den Diagnose-Logs in /diagnostic/index handelt es sich hierbei um detaillierte Logs, die Entwickler und Administratoren zum Debugging verwenden.
Obere Suchregion
📋 로그 [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
| Steuerelement | Breite | Beschreibung |
|---|---|---|
Zeitraum (search_time) | 280px | Start ~ Ende (zentriert, fett) |
Level (level) | 100px | Alle Level/INFO/WARN/ERROR |
Nachricht (message) | 250px (Standard: ausgeblendet) | Stichwortsuche. Anzeige je nach Betriebsumgebung |
Anzahl (limit) | 130px | 50/100/200/300/500/1,000 |
| Abfrage | Rot + 🔍 | search() |
| Gesamtausgabe | Rot + 📄 | downloadCSV() — Alle Logs der Suchkriterien als CSV |
Aktualisieren (realtime_icon) | Rot + ↻ | refresh() |
Der Standardwert des hidden-Feldes
app_nameistSERVER. Das bedeutet, dass in diesem Bildschirm nur Server-Applikationslogs abgefragt werden.
Timeline + Schneller Zeitbereich
Sechs Tasten für den schnellen Zeitbereich (10M/30M/1H/6H/12H/ALL) und eine Timeline (alarm_timeline), analog zum Diagnose-Bildschirm.
Log-Tabelle (6 Spalten)
Zeigt tiefergehende Code-Informationen an als der Diagnose-Bildschirm.
| Spalte | Breite | Beschreibung |
|---|---|---|
| Level | 80px | INFO/WARN/ERROR Farbbadge |
| Zeit | 160px | Zeitpunkt des Logs |
| Log-Klasse | 200px | Vollständiger Name der Java-Klasse |
| Methodenname | 120px | Aufgerufene Methode |
| Zeilennummer | 80px | Zeilennummer im Quellcode |
| Nachricht | Automatisch | Log-Inhalt + Stacktrace (falls vorhanden) |
Informationen zur Log-Klasse, Methode und Zeile sind für Systemadministratoren nützlich, um die genaue Position im Code beim Debugging zu identifizieren. Zur Nachverfolgung allgemeiner betrieblicher Anomalien ist der Diagnose-Bildschirm besser geeignet.
Konfigurations-Bildschirm (/config/index)
In diesem Bildschirm werden Key-Value-Einstellungen, die für den Systembetrieb erforderlich sind, hinzugefügt, bearbeitet oder gelöscht und der Cache aktualisiert.
Adresseinstellungen
Da die Platform die Adresse, die ein Benutzer im Browser eingibt, nicht selbst kennen kann, muss diese hier hinterlegt werden. Sie kann leer gelassen werden.
| Konfigurations-Key | Verwendung | Wenn leer |
|---|---|---|
PP_UI_CONSOLE_URL | Konsolenadresse. Wird in Alarm-Mails für den Link «Alarm prüfen» und in QR-Labeln verwendet | Mails werden ohne Link gesendet, QR-Label zeichnen keinen Code |
PP_UI_FRONTLINE_URL | Adresse der Frontline-App. Ziel der Schaltfläche «In Frontline öffnen» auf der öffentlichen QR-Seite | Schaltfläche wird ausgeblendet |
Der Wert ist eine absolute Adresse, die wie in https://plantpulse.example.com mit http(s) beginnt. Ein abschließender / wird abgeschnitten gespeichert; Queries oder # werden abgelehnt.
Einstellungen für den Mailserver (MAIL_*) werden ebenfalls hier vorgenommen — siehe Mail-Einstellungen.
Obere Werkzeuge
🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
| Steuerelement | Breite | Beschreibung |
|---|---|---|
Suche Konfigurations-Key (search_keyword) | 200px | Placeholder: "Suche Konfigurations-Key ..." |
| Abfrage | Rot + 🔍 | search() — Anwendung des Stichwortfilters |
| Aktualisieren | Rot + ↻ | refresh() |
| Konfiguration hinzufügen | Rot + ➕ | addConfig() — Öffnet das Formular für neue Konfigurationen |
| Neuerfassen | Blau + 🔄 | refreshCache() — Aktualisiert den Konfigurations-Cache ohne Serverneustart (Tooltip: "Aktualisiert den Konfigurations-Cache ohne Serverneustart.") |
Konfigurationslisten-Tabelle
| Spalte | Breite | Beschreibung |
|---|---|---|
| Konfigurations-Key | 300px | Vom System erkannter Key (z. B. engine.timeout.ms) |
| Konfigurationswert | 600px | Aktueller Wert des Keys |
| Beschreibung | Automatisch | Notiz zum Zweck des Keys |
| Änderungsdatum | 150px | Zeitpunkt der letzten Änderung |
| Aktion | 80px | Schaltflächen zum Bearbeiten/Löschen |
Am unteren Ende der Seite wird ein Informationskasten angezeigt.
ℹ️ Hinweis zu Systemkonfigurationen Hier werden die für den Systembetrieb erforderlichen Key-Value-Einstellungen verwaltet. Nach einer Änderung einiger Elemente kann ein Serverneustart erforderlich sein.
Formular zum Hinzufügen/Bearbeiten von Konfigurationen
Über die Schaltfläche Konfiguration hinzufügen oder die Aktionen in der Liste gelangt man zum Konfigurationsformular (/config/form).
| Eingabe | Beschreibung |
|---|---|
| Konfigurations-Key | Nur Buchstaben, Zahlen, . und _ zulässig. Beispiel: engine.timeout.ms |
| Konfigurationswert | Text (Zahlen, Boolean, JSON möglich, abhängig von der Key-Definition) |
| Beschreibung | Freitext (Notiz zur leichteren Identifikation durch den Operator) |
Um Änderungen sofort zu übernehmen, kehren Sie zum Listenbildschirm zurück und klicken Sie auf Neuerfassen. Einige Einstellungen erfordern eventuell einen Serverneustart.
Umgebungsinformations-Bildschirm (/env/view)
Dies ist ein Nur-Lese-Bildschirm, auf dem die Property-Dateien, die die Platform beim Booten einliest, in gruppierten Tabs angezeigt werden.
Oberer Informationskasten
❓ Systemumgebungsinformationen Zeigt die im Serversystem konfigurierten Umgebungsinformationen aufgeschlüsselt nach Property-Dateien an. Zur Änderung der Konfiguration bearbeiten Sie bitte die entsprechenden Dateien.
- Nach einer Änderung der Konfiguration muss der Server neu gestartet werden.
Aufbau der 6 Tabs
| Tab | Anzeige |
|---|---|
| Engine | Konfigurationen für den Engine-Core (Zeit, Threads, Queue-Limits etc.) |
| Applikation | Allgemeine Konfigurationen der Webapplikation |
| Message Queue | Verbindungseinstellungen für Message-Kanäle (Broker-Host, Authentifizierung, Topics etc.) |
| Storage | Verbindungseinstellungen für Zeitreihen- und Event-Speicher |
| SMTP-Einstellungen für den E-Mail-Versand | |
| WebSocket | Konfigurationen für Echtzeit-Push-Kanäle |
Tabellen in den Tabs (Gemeinsam)
| Spalte | Anzeige |
|---|---|
| Key | Property-Key |
| Konfigurationswert | Aktueller Wert (maskierte Passwörter werden als *** angezeigt) |
Im Umgebungsinformations-Bildschirm können Werte nicht geändert werden. Für Änderungen muss der Systemadministrator die entsprechende Property-Datei auf dem Server direkt bearbeiten und den Server anschließend neu starten. Key-Value-Paare, die direkt im Bildschirm geändert werden können, werden im Konfigurations-Bildschirm verwaltet.
Anwendungsszenarien
| Szenario | Bildschirm | Verfahren |
|---|---|---|
| PPS sinkt unter Normalwert | Monitoring | PPS-Panel-Diagramm → Infra-Health 5 Felder → Identifikation des Engpass-Nodes im Datenpipeline-Diagramm |
| Lange GC / Verdacht auf Memory Leak | Monitoring | GC-Zeitverlauf im JVM-Heap-Panel → Benachrichtigung des Systemadministrators |
| Prüfung des Betriebs nach Serverstart | Monitoring | Startzeit im Untertitel + alle 5 Felder der Infra-Health im Normalzustand + Anstieg der Zahlen an Pipeline-Nodes |
| Verfolgung von ERROR in einer Klasse | Logs | Level=ERROR + Stichwortsuche nach Klassenname → Analyse der Logs inklusive Zeilennummer |
| Temporäre Anwendung von Konfigurationsänderungen | Konfiguration | Konfiguration hinzufügen/bearbeiten → Neuerfassen (kein Neustart) |
| Änderung der Passwortrichtlinie oder Session-Zeit | Umgebungsinformationen | Aktuellen Wert im Applikations-Tab prüfen → Datei durch Systemadministrator bearbeiten → Serverneustart |
| Suche nach ausgefallener Verbindung | Verbindungsmanagement | Raster der Datenquellen-Karten im Status-Bildschirm → Karte anklicken → Details |
Häufig gestellte Fragen
Wobei unterscheidet sich der Monitoring-Bildschirm vom Diagnose-Bildschirm? Monitoring zeigt die Echtzeit-Betriebsmetriken der Platform (Durchsatz, Speicher, Health), während die Diagnose die INFO/WARN/ERROR-Event-Logs der einzelnen Module enthält. Beide werden vom Systemadministrator verwendet, aber Monitoring beantwortet «Wie sieht es jetzt aus?», während Diagnose beantwortet «Was ist passiert?».
Ein Feld der Infra-Health im Monitoring ist rot. Dies bedeutet, dass die entsprechende Komponente nicht reagiert oder der Health-Check fehlgeschlagen ist. Prüfen Sie sofort die ERROR-Logs des Servers oder der betroffenen Komponente im Diagnose-Bildschirm und benachrichtigen Sie gleichzeitig den Systemadministrator.
Ein Node im Datenpipeline-Diagramm ist grau. Dies bedeutet, dass diese Stufe nicht aktiviert ist oder keine Daten verarbeitet werden. Bei einigen Stufen (z. B. Backup oder Archivierung) ist Grau im Normalzustand korrekt; wenn es jedoch während eines erwarteten Ingress-Zeitfensters grau ist, könnte ein Problem vorliegen.
Die früher vorhandene «Verbindungs-Heatmap» ist nicht mehr sichtbar.
Diese wurde aus dem Monitoring-Bildschirm entfernt. Den Status der Verbindungen finden Sie im Raster der Datenquellen-Karten unter Verbindungsmanagement > Status. Durch Klicken auf eine Karte gelangen Sie zum Detailbildschirm (/connect/view).
Soll ich den Log-Bildschirm oder den Diagnose-Bildschirm verwenden? Zur Verfolgung von Anomaliesignalen nutzen Sie die Diagnose, für Debugging auf Code-Ebene die Logs. Wenn in der Diagnose ein ERROR mit unzureichender Nachricht gefunden wurde, prüfen Sie im Log-Bildschirm zur gleichen Zeit die detaillierten Logs dieser Klasse/Methode.
Ist die Schaltfläche «Neuerfassen» im Konfigurations-Bildschirm sicher? Sie aktualisiert nur den Speicher-Cache ohne Serverneustart. Dies ist für die meisten Einstellungen sicher, jedoch erfordern einige (z. B. Thread-Pool-Größe, DB-Connection-Pool) einen Neustart. Wenn die gewünschte Funktion nach der Neuerfassung nicht eintritt, wenden Sie sich an den Systemadministrator.
Ich möchte Werte in den Umgebungsinformationen direkt im Bildschirm ändern. Der Umgebungsinformations-Bildschirm ist schreibgeschützt. Änderungen müssen über die Bearbeitung der Property-Dateien auf dem Server erfolgen, gefolgt von einem Neustart. Key-Value-Paare, die im Bildschirm geändert werden können, werden im Konfigurations-Bildschirm verwaltet.
Die CSV-Datei der «Gesamtausgabe» in den Logs ist zu groß. Verkürzen Sie den Zeitraum der Suchkriterien (auf unter 1 Stunde) oder schränken Sie das Level auf ERROR/WARN ein und laden Sie die Datei erneut herunter. Alternativ können Sie die CSV-Datei in ein externes Analysewerkzeug importieren.
Aktualisiert sich der Monitoring-Bildschirm automatisch? Ja, das Monitoring wird per Echtzeit-Push automatisch aktualisiert. Wenn die Metriken stagnieren, prüfen Sie zuerst, ob der Echtzeit-Verbindungsstatus im Header rot ist.
Verwandte Bildschirme
- Dashboard — Hauptdashboard für Operatoren (KPI + Health-Leiste rechts)
- Diagnose — Diagnose-Logs pro Modul
- Tägliche Statistiken — Tägliche Betriebsstatistiken
- Verbindungsmanagement — Monitoring des Verbindungsstatus von Datenquellen
- Statuscode-Definition — Mapping von Infra-Health- und Verbindungsstatuscodes
- Sicherheitsverwaltung — Benutzer, Richtlinien und API-Token