System
Inhaltsverzeichnis
- Übersicht
- Bildschirmaufbau — Gruppe System
- Monitoring-Ansicht (
/monitoring/index) - Log-Ansicht (
/log/index) - Einstellungsansicht (
/config/index) - Ansicht Umgebungsinformationen (
/env/view) - Anwendungsszenarien
- Häufige Fragen
- Verwandte Ansichten
Übersicht
Das Menü System bündelt Betriebszustand, Sicherheitskonten, Einstellungen, Logs, Umgebungsinformationen und Cluster der Plattform selbst. Die Gruppe System im linken Menü enthält derzeit folgende Einträge.
| Untermenü | Interne URL / Externer Port | Zweck |
|---|---|---|
| Benutzer | /user/index | Verwaltung der Benutzerkonten |
| Sicherheitsrichtlinie | /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 Infrastruktur-Health, Datenpipeline und Engine-Metriken |
| Diagnose | /diagnostic/index | Anzeige von Systemdiagnose-Ereignissen |
| Log | /log/index | Chronologische Anzeige der Server-Anwendungslogs (auf Klassen-, Methoden- und Zeilenebene) |
| Einstellungen | /config/index | Verwaltung der Schlüssel-Wert-Einstellungen für das Systemverhalten (erneut anwenden/Neustart) |
| Umgebungsinformationen | /env/view | Anzeige der Umgebungswerte je Property-Datei in Registerkarten |
| Cluster | /cluster/index | Status der Cluster-Knoten |
| HA | /ha/index | Status der Hochverfügbarkeitskonfiguration |
| Audit | /audit/index | Audit-Log |
Dieses Dokument beschreibt schwerpunktmäßig Monitoring / Log / Einstellungen / Umgebungsinformationen. Zu Benutzern, Sicherheit und Token siehe Sicherheitsverwaltung, zur Diagnose siehe Diagnose, zu externen Werkzeugen siehe Standards und externe Werkzeuge.
Bildschirmaufbau — Gruppe System
| Ansicht | Hauptnutzer | Kurzbeschreibung |
|---|---|---|
| Monitoring | Systemadministrator | Infrastruktur-Health in 6 Feldern + Pipeline + 6 Engine-Metriken |
| Diagnose | Bediener/Administrator | Systemdiagnose-Ereignisse und INFO/WARN/ERROR-Verlauf |
| Log | Bediener/Administrator | Detaillierte Anwendungslogs inklusive Klasse, Methode und Zeile |
| Einstellungen | Systemadministrator | Schlüssel-Wert-Einstellungen hinzufügen, ändern, Cache erneut anwenden |
| Umgebungsinformationen | Systemadministrator | Anzeige der Property-Dateien (Engine/Anwendung/Message Queue/Storage/Mail/WebSocket), schreibgeschützt |
| Cluster | Systemadministrator | Cluster-Knoten, Modus, Latenz, Ressourcenstatus |
| HA | Systemadministrator | Status der Hochverfügbarkeitskonfiguration |
| Audit | Systemadministrator | Audit-Log |
Monitoring-Ansicht (/monitoring/index)
Zeigt die Echtzeit-Betriebsmetriken der Plattform selbst als Dashboard an.
Kopfbereich — Serverstartzeit
🩺 모니터링 YYYY-MM-DD HH:MM:SS 에 서버가 시작됨 [↻]
| Element | Anzeige |
|---|---|
| Seitentitel | 🩺 „Monitoring“ |
| Zusatzinformation | Serverstartzeit (kleine graue Schrift) — EngineManager.getInstance().getStartedDate() |
| Aktualisieren | Roter Button + ↻ — alle Metriken neu laden |
Infrastruktur-Health (Panel mit 6 Feldern)
Aufbau des oberen Panels mit sechs Feldern. Jede Zelle hat dieselbe Breite (ca. 16,66 %).
| Zelle | Symbol | Bezeichnung | ID des Anzeigewerts |
|---|---|---|---|
| 1 | 💾 (Speicher) | Cache | side_jmx_h_redis |
| 2 | 🔌 (Stecker) | WebSocket | side_jmx_h_stomp |
| 3 | 📡 (Satellitenschüssel) | MQTT | side_jmx_h_mqtt |
| 4 | 🌊 (Stream) | KAFKA | side_jmx_h_kafka |
| 5 | 🗄️ (DB) | Event Store | (Health-ID — Status des persistenten Ereignisspeichers) |
| 6 | 🕐 (Uhr) | Zeitreihen-Engine | side_jmx_h_timeseries |
Jede Zelle zeigt den Zustand normal/gestört als farbigen Text an. Sind alle normal, ist der Betrieb stabil.
Datenpipeline-Diagramm
| Element | Beschreibung |
|---|---|
| Kopfzeile | ⚡ „Datenpipeline“ |
| Inhalt | pipeline_diagram — Diagramm mit 580 px Höhe — visualisiert Knoten und Durchsatz im Ablauf Eingang → Prüfung → Transformation → Speicherung |
Über jedem Knoten werden Durchsatz (Ereignisse pro Sekunde), Wartestand und Drops angezeigt.
Verbindungs-Heatmap
🌐 연결 히트맵 N 에이전트
[■][■][■][■][■][■]... ← 24×24px 색 블록 그리드
─────────────────────────
🟢 정상 N 🟠 지연 N 🔴 이상 N ⬜ 미연결 N
| Element | Bedeutung |
|---|---|
| Kopfzeile | 🌐 „Verbindungs-Heatmap “ + N Agenten (Anzahl registrierter OPC) |
| Rasterinhalt | Farbblöcke je Datenquelle (eq-block 24×24 px) |
| Hover über Block | Tooltip mit Name und Typ der Datenquelle |
| Klick auf Block | /connect/view?opc_id=... Detailansicht in neuem Fenster |
Bedeutung der Farben (Kurzfassung)
| Farbe | Bedeutung | ID-Zähler |
|---|---|---|
| 🟢 Grün | Normal | heatmap_ok |
| 🟠 Orange | Verzögerung | heatmap_warn |
| 🔴 Rot | Störung | heatmap_error |
| ⬜ Grau | Nicht verbunden | heatmap_unknown |
6 Panels mit Engine-Metriken
Sechs Metrik-Panels in einem Raster aus 3 Spalten × 2 Zeilen. Jedes Panel besteht aus einer Schlüssel-Wert-Tabelle links und einem kleinen Diagramm rechts bzw. darunter.
1) PPS (Erfassung pro Sekunde · letzte Minute)
| Element | ID | Beschreibung |
|---|---|---|
| Aktuelle PPS | side_pps_current | Erfasste Punkte pro Sekunde (p/s) |
| Maximale PPS | side_pps_max | Maximalwert der letzten Minute (p/s) |
| Diagramm | side_realtime_chart (220 px) | Liniendiagramm über 1 Minute |
2) JVM-Heap
| Element | ID |
|---|---|
| Belegt | side_jmx_heap_used |
| Gesamt | side_jmx_heap_total |
| GC | side_jmx_gc (Millisekunden) |
| Diagramm | mon_jvm_chart (150 px) |
3) Pipeline
| Element | ID |
|---|---|
| Tasks | side_jmx_pipe_task |
| Abgeschlossen | side_jmx_pipe_processed |
| Warteschlange | side_jmx_pipe_pending |
| Diagramm | mon_pipeline_chart (100 px) |
4) Storage
| Element | ID |
|---|---|
| Gesamt gespeichert | side_jmx_store_saved |
| Schreibvorgänge/s | side_jmx_store_wps |
| Puffer-Warteschlange | side_jmx_store_buf |
| Aktive Batches | side_jmx_store_batch |
| Diagramm | mon_storage_chart (100 px) |
5) Messaging
| Element | ID |
|---|---|
| Gesamt empfangen | side_jmx_msg_total |
| Empfang pro Sekunde | side_jmx_msg_rate (/s) |
| KAFKA | side_jmx_msg_kafka |
| MQTT | side_jmx_msg_mqtt |
| Diagramm | mon_msg_chart (100 px) |
6) Streaming · Asynchron · Diagnose
In einem weiteren Bereich der Ansicht werden fortlaufend Streaming, asynchrone Executors und Diagnosezähler angezeigt (dieselbe Kategorie von Betriebskennzahlen wie Dashboard — Health-Leiste rechts).
Log-Ansicht (/log/index)
Zeigt die Logs der Serveranwendung auf Codeebene (Klasse, Methode, Zeile) in chronologischer Reihenfolge. Anders als die Diagnoselogs unter /diagnostic/index handelt es sich um detaillierte Logs, die Entwickler und Administratoren zum Debuggen verwenden.
Suchbereich im Kopf
📋 로그 [기간 ▭▭▭▭] [레벨 ▼] [건수 ▼] [조회] [전체 출력] [↻]
| Bedienelement | Breite | Beschreibung |
|---|---|---|
Zeitraum (search_time) | 280 px | Start bis Ende (zentriert, fett) |
Level (level) | 100 px | Alle Level/INFO/WARN/ERROR |
Meldung (message) | 250 px (standardmäßig ausgeblendet) | Stichwortsuche. Sichtbarkeit je nach Betriebsumgebung |
Anzahl (limit) | 130 px | 50/100/200/300/500/1.000 |
| Suchen | Rot + 🔍 | search() |
| Gesamtausgabe | Rot + 📄 | downloadCSV() — alle Logs der Suchbedingung als CSV |
Aktualisieren (realtime_icon) | Rot + ↻ | refresh() |
Der Standardwert des Hidden-Feldes
app_nameistSERVER. Diese Ansicht zeigt also ausschließlich die Logs der Serveranwendung.
Zeitleiste + schnelle Zeitbereiche
Dieselben sechs Schaltflächen für schnelle Zeitbereiche wie in der Diagnoseansicht (10M/30M/1H/6H/12H/ALL) sowie die Zeitleiste (alarm_timeline).
Log-Tabelle (6 Spalten)
Zeigt Informationen auf Codeebene, also eine Ebene tiefer als die Diagnoseansicht.
| Spalte | Breite | Beschreibung |
|---|---|---|
| Level | 80 px | Farbige Badges INFO/WARN/ERROR |
| Zeit | 160 px | Zeitpunkt des Logeintrags |
| Log-Klasse | 200 px | Vollständiger Java-Klassenname |
| Methodenname | 120 px | Aufgerufene Methode |
| Zeilennummer | 80 px | Zeilennummer im Quellcode |
| Meldung | automatisch | Logtext + Stack Trace (sofern vorhanden) |
Angaben zu Log-Klasse, Methode und Zeile sind nützlich, wenn der Systemadministrator die Codestelle beim Debuggen genau lokalisieren muss. Zum Nachverfolgen allgemeiner Betriebsauffälligkeiten eignet sich die Ansicht Diagnose besser.
Einstellungsansicht (/config/index)
Ansicht zum Hinzufügen, Ändern und Löschen der für das Systemverhalten erforderlichen Schlüssel-Wert-Einstellungen sowie zum erneuten Anwenden des Caches.
Werkzeuge im Kopfbereich
🎚️ 시스템 설정 [설정 키 검색 ...] [조회] [↻] | [➕ 설정 추가] [🔄 재적용]
| Bedienelement | Breite | Beschreibung |
|---|---|---|
Suche nach Einstellungsschlüssel (search_keyword) | 200 px | Platzhalter: „Einstellungsschlüssel suchen ...“ |
| Suchen | Rot + 🔍 | search() — Stichwortfilter anwenden |
| Aktualisieren | Rot + ↻ | refresh() |
| Einstellung hinzufügen | Rot + ➕ | addConfig() — Formular für neue Einstellung öffnen |
| Erneut anwenden | Blau + 🔄 | refreshCache() — Einstellungs-Cache ohne Serverneustart erneut anwenden (Tooltip: „Der Einstellungs-Cache wird ohne Serverneustart erneut angewendet.“) |
Tabelle der Einstellungen
| Spalte | Breite | Beschreibung |
|---|---|---|
| Einstellungsschlüssel | 300 px | Vom System erkannter Schlüssel (z. B. engine.timeout.ms) |
| Einstellungswert | 600 px | Aktueller Wert des Schlüssels |
| Beschreibung | automatisch | Notiz zum Zweck des Schlüssels |
| Änderungsdatum | 150 px | Zeitpunkt der letzten Änderung |
| Aktion | 80 px | Schaltflächen zum Bearbeiten und Löschen |
Am unteren Seitenrand wird ein Hinweisfeld angezeigt.
ℹ️ Hinweis zu Systemeinstellungen Hier werden die für das Systemverhalten erforderlichen Schlüssel-Wert-Einstellungen verwaltet. Nach einer Änderung kann für einige Einträge ein Serverneustart erforderlich sein.
Formular zum Hinzufügen/Bearbeiten
Über Einstellung hinzufügen im Kopfbereich oder über die Aktion in der Liste gelangen Sie zum Einstellungsformular (/config/form).
| Eingabe | Beschreibung |
|---|---|
| Einstellungsschlüssel | Nur Buchstaben/Ziffern/./_. Beispiel: engine.timeout.ms |
| Einstellungswert | Text (Zahlen, Boolean und JSON möglich, abhängig von der Schlüsseldefinition) |
| Beschreibung | Freitext (Notiz zur besseren Identifikation durch den Bediener) |
Um die Änderung sofort wirksam zu machen, kehren Sie zur Listenansicht zurück und klicken Sie auf Erneut anwenden. Bei einigen Einstellungen kann ein Serverneustart erforderlich sein.
Ansicht Umgebungsinformationen (/env/view)
Schreibgeschützte Ansicht, in der die beim Start von der Plattform eingelesenen Property-Dateien gruppiert in Registerkarten angezeigt werden.
Hinweisfeld im Kopfbereich
❓ Systemumgebungsinformationen Zeigt die im Serversystem konfigurierten Umgebungsinformationen je Property-Datei an. Ändern Sie die Umgebungseinstellungen direkt in der jeweiligen Datei.
- Nach einer Änderung der Einstellungen muss der Server neu gestartet werden.
Aufbau der 6 Registerkarten
| Registerkarte | Anzeige |
|---|---|
| Engine | Einstellungen des Engine-Kerns (Zeiten, Threads, Queue-Grenzen usw.) |
| Anwendung | Allgemeine Einstellungen der Webanwendung |
| Message Queue | Verbindungseinstellungen der Nachrichtenkanäle (Broker-Host, Authentifizierung, Topics usw.) |
| Storage | Verbindungseinstellungen für Zeitreihen- und Ereignisspeicher |
| SMTP-Einstellungen für den E-Mail-Versand | |
| WebSocket | Einstellungen des Echtzeit-Push-Kanals |
Tabelle jeder Registerkarte (einheitlich)
| Spalte | Anzeige |
|---|---|
| Schlüssel | Property-Schlüssel |
| Einstellungswert | Aktueller Wert (maskierte Passwörter werden als *** angezeigt) |
In der Ansicht Umgebungsinformationen können Werte nicht geändert werden. Für Änderungen muss der Systemadministrator die entsprechende Property-Datei auf dem Server direkt bearbeiten und anschließend den Server neu starten.
Anwendungsszenarien
| Szenario | Ansicht | Vorgehen |
|---|---|---|
| PPS liegt unter dem üblichen Wert | Monitoring | Diagramm im PPS-Panel → Infrastruktur-Health (6 Felder) → Engpassknoten im Datenpipeline-Diagramm identifizieren |
| GC dauert lange / Verdacht auf Speicherleck | Monitoring | Verlauf der GC-Zeit im JVM-Heap-Panel → Systemadministrator informieren |
| Normalbetrieb direkt nach Serverstart prüfen | Monitoring | Startzeit im Kopfbereich + alle 6 Zellen der Infrastruktur-Health normal + Verbindungs-Heatmap grün |
| ERROR einer bestimmten Klasse verfolgen | Log | Level=ERROR + Klassenname als Stichwort in der Meldungssuche → Loganalyse inklusive Zeilennummer |
| Einstellungsänderung vorübergehend anwenden | Einstellungen | Einstellung hinzufügen/ändern → Erneut anwenden (ohne Neustart) |
| Passwortrichtlinie/Sitzungsdauer ändern | Umgebungsinformationen | Aktuellen Wert in der Registerkarte Anwendung prüfen → Systemadministrator ändert die Datei → Serverneustart |
| Roten Block in der Verbindungs-Heatmap identifizieren | Monitoring | Auf den roten Block klicken → Detailansicht der Datenquelle in neuem Fenster |
Häufige Fragen
F. Worin unterscheidet sich die Monitoring-Ansicht von der Diagnoseansicht? A. Monitoring zeigt die Echtzeit-Betriebsmetriken der Plattform selbst (Durchsatz, Speicher, Health), Diagnose die INFO/WARN/ERROR-Ereignislogs je Modul. Beide werden vom Systemadministrator genutzt; Monitoring beantwortet „Wie ist der Zustand jetzt?“, Diagnose „Was ist passiert?“.
F. Mindestens ein Feld der Infrastruktur-Health im Monitoring ist rot. A. Die betreffende Komponente antwortet nicht oder der Health-Check ist fehlgeschlagen. Prüfen Sie umgehend in der Ansicht Diagnose die ERROR-Logs von SERVER oder der betreffenden Komponente und informieren Sie gleichzeitig den Systemadministrator.
F. Ein Knoten im Datenpipeline-Diagramm ist grau. A. Diese Stufe ist nicht aktiviert oder es liegen keine zu verarbeitenden Daten vor. Bei manchen Stufen ist Grau im Normalbetrieb üblich (z. B. Backup, Archivierung); ist ein Knoten jedoch während der Erfassungszeit grau, kann ein Problem vorliegen.
F. Ein Block in der Verbindungs-Heatmap ist rot.
A. Die Verbindung dieser Datenquelle ist gestört. Öffnen Sie per Klick auf den Block die Detailansicht (/connect/view) oder prüfen Sie in der Ansicht Verbindungsverwaltung > Status links die 24-Stunden-Historie.
F. Sollte ich die Log- oder die Diagnoseansicht verwenden? A. Für die Verfolgung von Störungssignalen die Diagnose, für Debugging auf Codeebene das Log. Wenn in der Diagnose ein ERROR erfasst wurde, die Meldung aber nicht ausreicht, sehen Sie sich zusätzlich in der Log-Ansicht die Detaillogs derselben Klasse/Methode zum gleichen Zeitpunkt an.
F. Ist die Schaltfläche „Erneut anwenden“ in der Einstellungsansicht sicher? A. Sie aktualisiert lediglich den Speicher-Cache, ohne den Server neu zu starten. Für die meisten Einstellungen ist das unbedenklich, einige (Thread-Pool-Größe, DB-Verbindungspool usw.) erfordern jedoch einen Neustart. Verhält sich das System nach dem erneuten Anwenden nicht wie erwartet, wenden Sie sich an den Systemadministrator.
F. Ich möchte Werte der Umgebungsinformationen in der Ansicht ändern. A. Die Ansicht Umgebungsinformationen ist schreibgeschützt. Für Änderungen müssen die Property-Dateien auf dem Server bearbeitet und der Server neu gestartet werden. In der Oberfläche änderbare Schlüssel-Werte werden in der Ansicht Einstellungen verwaltet.
F. Die CSV-Datei der „Gesamtausgabe“ im Log ist zu groß. A. Grenzen Sie den Zeitraum der Suchbedingung ein (unter 1 Stunde) und beschränken Sie das Level auf ERROR/WARN, und laden Sie erneut herunter. Alternativ übernehmen Sie die CSV-Datei nach dem Download in ein externes Analysewerkzeug.
F. Aktualisiert sich die Monitoring-Ansicht automatisch? A. Ja, das Monitoring wird per Echtzeit-Push automatisch aktualisiert. Stehen die Metriken still, prüfen Sie zunächst, ob der Echtzeit-Verbindungsstatus in der Kopfzeile rot ist.
Verwandte Ansichten
- Dashboard — Haupt-Dashboard für Bediener (KPI + Health-Leiste rechts)
- Diagnose — Diagnoselogs je Modul
- Tagesstatistik — tägliche Betriebsstatistik
- Verbindungsverwaltung — Überwachung des Verbindungsstatus der Datenquellen
- Definition der Statuscodes — Zuordnung der Codes für Infrastruktur-Health und Verbindungsstatus
- Sicherheitsverwaltung — Benutzer, Richtlinien, API-Token