Startbildschirm (/ui/main) — Karten / Aktionen / Aktualisierungsintervalle: der vollständige Leitfaden
Die Hauptseite der Gateway-Weboberfläche. Sie zeigt sämtliche Betriebszustände des Gateways in Kartenform auf einem einzigen Bildschirm. Die Karten holen sich ihre Werte im 1-Sekunden-Takt erneut vom Backend (/monitor/bean) und aktualisieren sich; nur die Sparkplug B-Karte wird abweichend alle 5 Sekunden (/api/v1/transfer) aktualisiert.
Zugriff über das PlantPulse-Logo oben links oder direkt über http://<gateway>/ui/main.
- Karten MQTT / Sparkplug B / OPC UA Server: direkter Lookup der Schlüssel
*.enable/host/port/userinapp.properties. Da install.sh pro Box ein zufälliges Passwort erzeugt, ist user ggf. leer oder wird pro Box unterschiedlich angezeigt. - Karte Docker:
/var/run/docker.sockmuss gemountet sein.plantpulse-edgeschließt sich selbst aus (self-exclude) — es erscheint nicht in der Liste (sichere Sperre gegen start/stop/delete). - Karte Netzwerk (LAN1/LAN2/WiFi/GSM/VPN/Verwaltung): Zuordnung über die Werte aus
edge.net.<role>.iface. Bei systemd-predictable-Namen wieenp1s0 / enp2s0 / tailscale0(z. B. auf Dev-Boxen) direkt inapp.propertieskonfigurieren (kann über die env-VariableLAN1_IFACE=...in install.sh automatisch übernommen werden). - Komponenten-Health in einer Zeile prüfen:
curl http://localhost/api/v1/system/health(keine Authentifizierung erforderlich, Status-Map über 8 Komponenten + 503-Verzweigung).
Alle Karten auf einen Blick (insgesamt ca. 30)
Raster mit 6 Spalten. Es gibt 3 Kartentypen:
| Typ | Farbe | Bedeutung |
|---|---|---|
| action_box (weißer Hintergrund, großes Symbol) | grauer Rahmen | Klick führt zum jeweiligen Menü |
| black_box (schwarzer Hintergrund) | graue Schrift | Unveränderliche Gateway-Informationen |
| gray_box (weißer Hintergrund, grauer Header) | Hellgrau | Echtzeitüberwachung — Werte aktualisieren sich jede Sekunde |
1. Aktionen / Informationen im oberen Bereich (Zeile 1)
1.1 엣지 정보 (black_box)
Was wird angezeigt: Die unveränderlichen Identitätsinformationen dieses Gateways. Sie werden einmalig beim Bootvorgang ermittelt und bleiben fest im Bildschirm stehen.
| Feld | Bedeutung | Quelle |
|---|---|---|
| HOST-Name | Hostname des OS (z. B. pe-edge-01) | EdgeContext.hostname |
| O/S | OS-Name + Architektur (z. B. Linux (amd64)) | os.name + os.arch |
| Kernel | Kernel-Version (z. B. 5.14.0-...) | os.version |
| Version | SW-Version des Gateways (z. B. V2026.05.08) | app.properties |
| Build-Datum | Build-Datum des Artefakts (z. B. 2026-05-08) | BUILD_DATE |
⚠ HOST-Name und O/S-Informationen ändern sich nur, wenn sich das OS nach einem Neustart des Gateways geändert hat.
1.2 프로토콜 연결 하기 (action_box)
→ Klick führt zu /ui/connect/connect. Bildschirm zum Hinzufügen einer neuen PLC-/OPC-UA-/MQTT-/Simulator-Verbindung.
1.3 연결된 목록 (N) (action_box)
→ Klick führt zu /ui/connect/list. Das N in Klammern ist die Anzahl der aktuell registrierten OPC (Verbindungen) (monitor.opc_count).
1.4 애플리케이션 (action_box)
→ /ui/apps. Docker-basierte Benutzeranwendungen starten/stoppen/verwalten.
1.5 노-코드 플로우 (action_box)
→ /ui/flow (Node-RED eingebettet).
Ausführliche Anleitung: Flow (Node-RED)
1.6 환경 설정 (action_box)
→ /ui/system/config. Direktes Bearbeiten von app.properties + Systemneustart / Reboot / Backup / Bereinigen temporärer Dateien usw.
2. Gateway-Identifikation (3 Karten)
2.1 엣지 시작 시간 (gray_box)
Was wird angezeigt: Der exakte Zeitpunkt des letzten Bootvorgangs des Gateways (Tomcat) — yyyy년 MM월 dd일 [a] HH시 mm분 ss초 (KST).
Wenn Zweifel am Neustartzeitpunkt bestehen, prüfen Sie hier den „letzten Neustart".
2.2 엣지 ID (gray_box)
Was wird angezeigt: Die eindeutige ID dieses Gateways (z. B. EDGE_00303). Sie ist die Grundlage jeder Identifikation — Sparkplug, REST API, OPC-UA-Knotenbaum usw. Stammt aus edge.id in app.properties.
2.3 배포 사이트 ID (gray_box)
Was wird angezeigt: An welchem Standort (Werk / Linie) dieses Edge eingesetzt wird (z. B. SITE_00001). Wird zur Bestimmung der Group ID für externe SCADA / Sparkplug verwendet. Stammt aus site.id in app.properties.
3. Netzwerkstatus (6 Karten)
Jede Karte zeigt Link-Status-Symbol + IP oder DISCONNECTED (grau).
3.1 인터넷 (gray_box)
Ob das Gateway das externe Internet per Ping erreichen kann. Symbolfarbe:
- Grüner Globus: Verbindung in Ordnung
- Roter Globus: Verbindung fehlgeschlagen
Ping-Ziel ist monitor.ping.targets in app.properties (z. B. 8.8.8.8).
3.2 이더넷 (gray_box) — in zwei Felder geteilt
- Links: 1 WAN (NIC des externen Netzes,
net_1_ip) - Rechts: 2 PLC (NIC des PLC-Netzes,
net_2_ip)
Die Farbe beider Felder ändert sich gemeinsam abhängig vom Ergebnis des Internet-Pings (vereinfachte Darstellung).
3.3 WIFI (gray_box)
Symbol wifi-1 + IP, oder wifi-slash in Grau (DISCONNECTED).
3.4 3G/4G/5G (gray_box)
IP des GSM-Modems oder DISCONNECTED. SIM-Karten-Symbol.
3.5 VPN (gray_box)
Symbol shield-check. Bei bestehender VPN-Verbindung wird die IP angezeigt, andernfalls grau + DISCONNECTED.
3.6 관리 포트 (gray_box)
Symbol wrench. IP der USB- bzw. separaten Management-NIC. In der Regel ein vom Standortnetzwerk getrennter Diagnosekanal.
4. Systemressourcen (5 Karten)
4.1 온도 (gray_box)
CPU-Temperatur. Ab 90 °C rot + Symbol temperature-high (kritisch), darunter grün + temperature-low. Im industriellen Umfeld das erste Anzeichen für verstopfte Lüfter / Übertemperatur-Alarm.
4.2 CPU (gray_box)
Anzeige (0–100 %) + Gesamtzahl der Kerne. Bibliothek JustGage. Aktualisierung im 1-Sekunden-Takt.
Wird dauerhaft 90 % überschritten, sollten PLC-Polling-Intervall / Anzahl der Tags überprüft werden.
4.3 물리 메모리 (gray_box)
Anzeige + 사용 / 전체 (automatische Einheit KB/MB/GB). RSS-Verbrauch unabhängig vom Swap.
4.4 가상 메모리 (gray_box)
Swap-Auslastung. Anzeige + 사용 / 전체. Normalerweise 0–10 %; dauerhaft über 30 % deutet auf RAM-Mangel hin.
4.5 디스크 (gray_box)
Auslastung von /data1 (oder des Gateway-Home). Anzeige + 사용 / 전체.
Über 90 % umgehend die Prozedur Bereinigung / Cleanup (clean.sh / node-cleanup.sh) ausführen.
5. Netzwerkverkehr (1 Karte)
5.1 네트워크 사용량 (gray_box)
- Download (RX) — kumulierte empfangene Bytes
- Upload (TX) — kumulierte gesendete Bytes
Automatische Einheit KB/MB/GB. Kumulierter Wert seit dem Bootvorgang.
6. Erfassung / Verarbeitung (4 Karten)
6.1 연결 | 태그 건수 (gray_box)
- Große Zahl oben: Anzahl der Verbindungen (OPC) (
opc_count) - Große Zahl unten: Anzahl der Tags (
tag_count)
Die Gesamtzahl der dem Gateway bekannten OPC/Tags. Systemtags (EDGE_*) sind eingeschlossen.
6.2 PLC 연결 및 수집 상태 (gray_box) — 2x4-Matrix
| Links (Verbindung) | Bedeutung |
|---|---|
| 🟢 Verbunden | Anzahl OPC mit intakter TCP/UDP-Verbindung (plc_con_connected_count) |
| 🔴 Getrennt | Anzahl OPC mit fehlgeschlagener Verbindung (plc_con_disconnected_count) |
| Rechts (Erfassung) | Bedeutung |
|---|---|
| 🟢 Normal | Erfassung gestartet + Lesevorgänge erfolgreich (plc_scan_start_count) |
| 🟧 Störung | Erfassung gestartet, aber Lesevorgänge seit einiger Zeit fehlgeschlagen (plc_scan_not_collect_count) |
| ⬜ Gestoppt | OPC, die der Benutzer gestoppt hat (plc_scan_stop_count) |
Verbindung und Erfassung sind zweierlei: Auch wenn TCP intakt ist (Verbindung ✅), wird ein aus beliebigem Grund ausbleibender Lesevorgang als Erfassungsstörung eingestuft.
6.3 PLC 읽기/쓰기 결과 (gray_box)
Von Erfassungsdienst/REST API kumulierte read/write-Zähler. Verdichtete Darstellung in K/M/B.
| Erfolgreich | Fehlgeschlagen | |
|---|---|---|
| Lesen (R) | plc_value_read_success_count | plc_value_read_error_count |
| Schreiben (W) | plc_value_write_success_count | plc_value_write_error_count |
Klick auf das Symbol ↻ Aktualisieren oben rechts → Aufruf von /connect/reset-read-error → nur die Fehlerzähler werden auf 0 zurückgesetzt. Nützlich, wenn nach dem Abarbeiten von Alarmen ab dem nächsten Zyklus neu gezählt werden soll.
6.4 MPS (gray_box)
Messages Per Second — Anzahl der pro Sekunde verarbeiteten Datenpunkte (monitor.mps).
Direkt darunter eine Sparkline (Mini-Diagramm des jüngsten Verlaufs). Lastveränderungen auf einen Blick.
Liegt der mps eines Standorts üblicherweise bei 100 und fällt plötzlich auf 0 → PLC-Verbindung oder Erfassung gestört.
7. Übertragung / Speicherung (5 Karten)
7.1 대기 큐 (gray_box)
Größe der Warteschlange der zur Übertragung anstehenden Punkte (queue_size).
Normalerweise 0 bis einige Dutzend. Ist die externe Übertragung blockiert (z. B. Sparkplug getrennt), steigt der Wert schnell an → Überlauf in die Disk-Queue (
queue_disk_size). Wächst diese Karte kontinuierlich, muss die externe Kommunikation geprüft werden.
7.2 포인트 전송 건수 (gray_box)
Kumulierte Anzahl der seit dem Bootvorgang erfolgreich nach außen übertragenen Punkte (sended_point_count).
7.3 포인트 전송량 (gray_box)
Kumulierte gesendete Bytes seit dem Bootvorgang (sended_point_bytes). Automatische Einheit. Referenz für die Abrechnung des Datenvolumens.
7.4 데이터 저장량 (gray_box)
Gesamtgröße der im Cassandra-Keyspace pe gespeicherten Zeitreihen (Eingabe in MBytes → automatische Einheitenumrechnung). Zusammen mit dem freien Speicherplatz betrachten.
7.5 데이터 저장 기간 (gray_box)
TTL (Time-To-Live) von tm_tag_point in Tagen (system_db_ttl, Standard 30 Tage). Nach Ablauf dieser Anzahl von Tagen erfolgt eine automatische Löschung. Änderung unter app.properties.
8. Systemfehler (1 Karte)
8.1 시스템 오류 (오늘) (gray_box)
Anzahl der heute (00:00 bis jetzt) aufgetretenen Systemlog-Einträge der Stufe ERROR (system_error_count). Große rote Zahl.
Klick auf die Zahl → /system/log/list, um den tatsächlichen Logtext einzusehen.
9. Externe Dienste / Integration (5 Karten)
Jede Karte zeigt einen Statusbalken (grün/rot/grau) + eine Tabelle mit Verbindungsdaten.
9.1 플랫폼 API 서버 (gray_box)
Verbindungsstatus zur übergeordneten PlantPulse-Plattform-API. Ein Klick auf das Symbol für externe Links oben rechts öffnet diesen Server in einem neuen Fenster.
| Zeile | Bedeutung |
|---|---|
| Balken | 🟢 Verbindung erfolgreich / 🔴 Verbindung fehlgeschlagen (monitor.api) |
| HOST/IP | server.host |
| PORT | server.port |
| USER | server.username |
9.2 OPC-UA 서버 (gray_box)
Informationen zum integrierten OPC-UA-Server des Gateways. Externe SCADA-Systeme verbinden sich hierher und abonnieren Tags.
| Zeile | Bedeutung |
|---|---|
| Balken | 🟢 Aktiviert (der Server läuft immer) |
| HOST/IP | opc.ua.server.host |
| PORT | opc.ua.server.tcp.port (Standard 12000) |
| USER | opc.ua.server.user |
Ausführlich zu Knotenbaum / Zeitreihendiagrammen: OPC-UA Node-Viewer verwenden
9.3 MQTT 서버 (gray_box)
Informationen zum integrierten HiveMQ des Gateways + Topic, auf dem u. a. Sparkplug publiziert wird.
| Zeile | Bedeutung |
|---|---|
| Balken | 🟢 Aktiviert / ⬜ Deaktiviert (mqtt.enable) |
| HOST/IP | mqtt.server.host |
| PORT | mqtt.server.port (Standard 1883) |
| USER | mqtt.server.user |
| TOPIC | mqtt.server.topic (Sparkplug spBv1.0/... oder benutzerdefiniertes Topic) |
9.4 Sparkplug B (gray_box)
Echtzeitstatus der Sparkplug-Publishing-Komponente (Aktualisierung alle 5 Sekunden, Eintrag Sparkplug in /api/v1/transfer).
| Zeile | Bedeutung |
|---|---|
| Balken | 🟢 Aktiviert (verbunden) / 🔴 Verbindung getrennt (aktiv, aber Broker-Verbindung getrennt) / ⬜ Deaktiviert (sparkplug.enable=false) |
| GROUP | Sparkplug Group ID (z. B. Plant1) |
| NODE | Edge Node ID (z. B. EDGE_00303) |
| Sitzung # | bdSeq (Device-Birth/Death-Sequenz — Anzahl der Wiederverbindungen) |
| Nachricht # | seq (Nummer der aktuell publizierten Nachricht — Umlauf 0–255) |
Bleibt Nachricht # stehen, ist die Übertragung unterbrochen. Steigt Sitzung # häufig, ist die Broker-Verbindung instabil.
9.5 도커 (gray_box)
Status des Docker-Daemons + Statistiken zu den Containern der Benutzeranwendungen.
| Zeile | Bedeutung |
|---|---|
| Balken | 🟢 In Betrieb / 🔴 Gestoppt (monitor.docker_on) |
| Anzahl | Anzahl der [ 살아있는 / 전체 ]-Container (docker_container_up_count / docker_container_total_count) |
Auf einen Blick erkennbar, ob alle unter /ui/apps registrierten Anwendungen laufen.
10. Footer (auf allen Seiten gleich)
Am unteren Bildschirmrand wird Folgendes angezeigt.
- Text PlantPulse Edge + Lizenz
- ☁ Symbol Software-Upgrade — Klick ruft
upgrade.shauf (nach Bestätigungsdialog)- Badge neben dem Symbol:
- Rot „Upgrade verfügbar!" → auf dem Download-Server liegt eine neue Version vor
- Grau „Keine Verbindung zum Download-Server" → Zugriff auf externes Netz /
product.kopens.iofehlgeschlagen - (kein Badge) → die aktuelle Version ist die neueste
- Badge neben dem Symbol:
- Verknüpfungen zu externen Ports — Öffnen weiterer externer Dienste (z. B. Grafana 3000) in einem neuen Fenster
Intern holt /config/upgrade/check per Server-to-Server https://product.kopens.io/.../VERSION.JSON und vergleicht → saubere Badge-Anzeige ohne CORS-Fehler.
11. Übersicht: Aktualisierungsintervalle / Datenquellen
| Bereich | Aktualisierungsintervall | Endpunkt |
|---|---|---|
| Anzeigen / Ressourcen / Netzwerk / Zähler / Queue / Speichervolumen / Fehler | 1 Sekunde | GET /monitor/bean |
| Sparkplug B-Karte | 5 Sekunden | GET /api/v1/transfer |
| Upgrade-Badge | einmalig beim Laden der Seite | GET /config/upgrade/check |
| Schwarze Infokarten (HOST-Name/OS/Version usw.) | keine Aktualisierung (Wert zum Ladezeitpunkt der Seite) | EdgeContext (beim Serverstart festgelegt) |
12. Häufig beobachtete Muster
| Signal auf dem Bildschirm | Verdacht / Maßnahme |
|---|---|
| Temperatur rot (≥ 90 °C) | Lüfter verstopft / Umgebungstemperatur — sofortige Inspektion |
| CPU dauerhaft 90 %+ | Polling-Intervall zu kurz / zu viele Tags |
| Festplatte 90 %+ | Bereinigung / Cleanup — clean.sh + node-cleanup.sh |
| PLC getrennt — Zähler steigt plötzlich | Kabel des PLC-Netzes / Switch / PLC-Stromversorgung |
| Erfassungsstörung > 0 | Verbindung in Ordnung, aber Lesen schlägt fehl — Adressformat / PLC-Firmware prüfen |
| MPS fällt auf 0 | Alle PLC-Lesevorgänge schlagen fehl oder der Erfassungsdienst steht |
| Warteschlange wächst kontinuierlich | Externe Übertragung (Sparkplug / MQTT) blockiert — Karten 9.3/9.4 prüfen |
| Systemfehler rote Zahl | Klick → Text unter /system/log/list prüfen |
| Sparkplug Nachricht # ändert sich nicht | Übertragung unterbrochen — sparkplug.* in app.properties prüfen |
| Docker rot | Daemon-Status unter systemctl status docker prüfen |
13. Weiterführende Informationen
- Verbindung hinzufügen: Neue PLC-Verbindung hinzufügen
- Verbindungsliste / Tag-Bildschirm: Echtzeitwerte anzeigen
- OPC-UA Node-Viewer: OPC-UA Node-Viewer verwenden
- Flow-Automatisierung: Einstieg in Flow (Node-RED)
- Systemkonfiguration / Betriebsskripte: Betrieb — auf einen Blick