Pi-Node Monitor | Offizielle WEB Seite

Pi-Node Monitor (Beta 0.01) – Dokumentation

1. Übersicht: Leistung, Kompatibilität & Vorteile

Der Pi-Node Monitor (Beta) ist eine leichtgewichtige, performante Überwachungslösung für Pi-Netzwerk-Knoten. Die Anwendung wurde speziell dafür entwickelt, Node-Betreibern maximale Transparenz über den aktuellen Systemzustand, die Blockchain-Synchronisation und die Netzwerk-Konnektivität zu liefern, verpackt in ein immersives Cyberpunk-Dashboard.

Leistungsmerkmale:

  • Echtzeit-Metriken: Zyklische Abfrage der lokalen Node-API im Hintergrund ohne spürbaren System-Overhead.
  • Ressourcenschonend: Dank Python 3.11 auf Flask-Basis benötigt der Container im Idle-Zustand minimale CPU-Zyklen und extrem wenig Arbeitsspeicher.
  • Live-Updates: Automatische Aktualisierung von Blockhöhe, Peer-Verbindungen und Telemetriedaten im Frontend per JavaScript (JSON-Polling), komplett ohne manuellen Page-Reload.

Kompatibilität:

  • Multi-Architektur-Support: Native, optimierte Docker-Images sowohl für klassische 64-Bit Serverumgebungen (amd64) als auch für ressourceneffiziente Einplatinencomputer wie den Raspberry Pi (arm64).
  • Container-Native: Nahtlose Integration in bestehende Docker- und Docker-Compose-Infrastrukturen ohne externe Paketabhängigkeiten auf dem Host-System.

Vorteile auf einen Blick:

  • Schnelle Fehlererkennung: Sofortiges visuelles Feedback bei Abweichungen im Quorum-Lag, der Konsens-Phase oder bei Verbindungsverlusten.
  • Strikte Kapselung: Die Versionskontrolle erfolgt fest auf Modulebene innerhalb der App-Logik (keine anfällige Injection oder Hardcoding im Template).
  • Optimiertes UI-Design: Hochgradig lesbare Monospace-Typografie mit reaktivem Tailwind CSS Cyberpunk-Theme für den professionellen 24/7 Monitoring-Einsatz.

2. Systemanforderungen

KomponenteMindestanforderungEmpfohlen
Prozessor (CPU)x86_64 (amd64) oder ARMv8 (arm64) // 2 Kerne4 Kerne oder mehr
BetriebssystemLinux (z. B. Ubuntu Server, Debian, Raspberry Pi OS) / WINDOWSLinux mit systemd / macOS / WINDOWS
LaufzeitumgebungDocker Engine v20.10+ & Docker Compose v2.0+ / WSL 2 mit Docker Desktop für WINDOWSAktuellste stabile Docker Desktop / Engine Version
NetzwerkLokaler Zugriff auf die API des laufenden Pi-NodesStabile LAN-Anbindung mit statischer IP-Zuweisung

3. Installation & Konfiguration

3.1 Bereitgestellte Docker-Images

Die Container-Images werden getrennt nach Zielarchitektur über die GitHub Container Registry (ghcr.io) bereitgestellt:

  • Für AMD64/x86_64 Systeme: ghcr.io/Klissner/pi-node-monitor:beta-0.01-amd64
  • Für ARM64 (z.B. Raspberry Pi, Mac M-Series): ghcr.io/Klissner/pi-node-monitor:beta-0.01-arm64

3.2 Docker-Compose Konfiguration

Erstellen Sie eine docker-compose.yml in Ihrem Projektverzeichnis. Passen Sie das Image-Tag entsprechend Ihrer Systemarchitektur an (-amd64 oder -arm64):

YAML

services:
  pi-monitor:
    image: ghcr.io/klissner/pi-node-monitor:beta-0.01-amd64      # x86 systems
    # image: ghcr.io/klissner/pi-node-monitor:beta-0.01-arm64    # Raspberry Pi / Apple Silicon
    container_name: pi-monitor
    restart: unless-stopped
    ports:
      - "${MONITOR_PORT}:${MONITOR_PORT}"
    env_file:
      - .env
    volumes:
      - ./app-data:/app/data

Beschreibung des Inhalts: Die Konfiguration definiert den Service pi-monitor. Das Port-Mapping leitet den Traffic von Port 8080 des Host-Systems an den internen Flask-Port 8080 weiter. Über env_file werden Umgebungsvariablen aus der .env-Datei geladen, um die Infrastruktur-Parameter dynamisch anzupassen. Ein automatisches Log-Rotations-Limit schützt den Festplattenspeicher vor dem Überlaufen.

3.3 Umgebungsvariablen (.env)

Erstellen Sie eine Konfigurationsdatei namens .env (oder .inv) im selben Verzeichnis wie die docker-compose.yml und tragen Sie alle erforderlichen Parameter ein:

  • NODE_IP=192.168.x.x Definiert die IP-Adresse des Ziel-Hosts, auf dem der Pi-Netzwerk-Knoten läuft und seine API bereitstellt.
  • NODE_PORT=11626 Der Netzwerkport, über den die lokale Status-API des Pi-Nodes abgefragt wird.
  • MONITOR_PORT=8080 Der externe Port des Host-Systems, unter dem das Web-Interface des Pi-Node Monitors im Browser aufgerufen werden kann.
  • REFRESH_INTERVAL=10 Das Zeitintervall in Sekunden, in dem das Backend die Daten des Pi-Nodes zyklisch neu abfragt und aktualisiert.
  • TIMEZONE=Asia/Bangkok Die zu verwendende Zeitzone für die korrekte Darstellung und Synchronisation von Zeitstempeln innerhalb der Anwendung.
  • LANGUAGE=de Die Standard-Spracheinstellung für die Lokalisierung der Benutzeroberfläche und Systemmeldungen. Verfügbar sind de=Deutsch und en=Englisch.
  • UPDATE_API_URL=[https://api.github.com/repos/pi-apps/pi-node-docker/releases/latest](https://api.github.com/repos/pi-apps/pi-node-docker/releases/latest)Der API-Endpunkt zum GitHub-Repository, der verwendet wird, um automatisch auf neuere Versionen oder Releases des zugrundeliegenden Docker-Setups zu prüfen.

3.4 Grafische Benutzeroberfläche (GUI) & Anzeigefelder

Das Dashboard ist in eine obere Statusleiste sowie zwei funktionale Hauptbereiche und ein Info-System im Footer unterteilt. Nachfolgend werden alle Werte und Ausgaben im Detail beschrieben:

Obere Status- & Live-Leiste

  • STATUS: Der aktuelle Synchronisationszustand des Knotens. Zeigt ● SYNCED! in hellem Grün an, wenn der lokale Knoten vollständig mit dem Netzwerk synchron läuft.
  • AKTUELLER BLOCK: Die aktuelle Blocknummer, die Ihr lokaler Pi-Node verarbeitet hat.
  • GESAMT-BLÖCKE: Die offizielle, globale Gesamtanzahl der Blöcken im Pi-Netzwerk zum Abgleich der Kette.
  • LETZTER BLOCK VOR: Ein Live-Timer, der angibt, vor wie vielen Sekunden der letzte Block erfolgreich empfangen bzw. verarbeitet wurde (z. B. 4s).
  • PEERS: Die Anzahl der direkt verbundenen Nachbarknoten (Nachbarn) im P2P-Netzwerk (z. B. 6).
  • UPTIME: Die kontinuierliche Betriebsdauer des Monitors bzw. des Containers seit dem letzten Start (z. B. 2d 1h).

Linkes Panel: SYSTEM-KERNDATEN

  • Software-Version: Die aktuell installierte Core-Version des überwachten Pi-Nodes (z. B. v24.1.0).
  • Netzwerk-Identifikation: Das Netzwerk, mit dem der Knoten verbunden ist (festgelegt auf Pi Network).
  • Protokoll-Version: Die aktive Version des zugrundeliegenden Blockchain-Protokolls (z. B. 24).
  • Wartende Peers: Die Anzahl der eingehenden oder wartenden Verbindungsanfragen anderer Knoten im Netzwerk (z. B. 4).
  • Letzter Startzeitpunkt: Das genaue Datum und die Uhrzeit des letzten System- oder Node-Neustarts (z. B. 6.7.2026, 21:50:33).
  • Letzter Block-Hash: Der eindeutige kryptografische SHA-256 Identifikations-Hash des zuletzt verarbeiteten Blocks, dargestellt in einer dunklen Monospace-Box.
  • TERMINAL / KONFIG_ÜBERSCHREIBEN: Eine interaktive Eingabezeile im UI, mit der temporär oder dauerhaft die Ziel-IP, der Port sowie das Sprachkürzel (z. B. DE) über ein Klick-Event (SET) übergeben werden können.

Rechtes Panel: KONSENS & QUORUM-MATRIX

  • Knoten-Identität: Die eindeutige, verkürzte kryptografische Kennung (Public Key) Ihres spezifischen Validierungsknotens (z. B. GCCEN).
  • Ertrags-Index (KPI): Der prozentuale Leistungs- und Verfügbarkeitsindex des Knotens im Konsens-Verbund (optimal bei 100 %).
  • Konsens-Phase: Der aktuelle Status innerhalb des Stellar-Konsens-Protokolls (SCP). EXTERNALIZE signalisiert in Grün, dass der Knoten aktiv an der finalen Bestätigung und Validierung von Blöcken teilnimmt.
  • Ausfalltoleranz (Knoten): Die maximale Anzahl an Validierungsknoten innerhalb Ihres Quorums, die zeitgleich ausfallen dürfen, ohne dass Ihr eigener Knoten den Konsens verliert (z. B. 2).
  • Netzwerk-Verzögerung: Die aktuelle Latenzzeit der Netzwerknachrichten im Konsens-Protokoll, gemessen in Millisekunden (z. B. 118 ms).
  • Zustimmende Knoten: Die Anzahl der aktiven Validierungsknoten im Quorum, die dem aktuellen Konsens-Status zustimmen (z. B. 3).
  • Fehlende Antworten: Die Anzahl der Knoten im konfigurierten Quorum, die aktuell nicht antworten oder offline sind (optimal bei 0).
  • Transitive Knotenmenge: Die Gesamtanzahl aller erreichbaren Knoten im erweiterten, verknüpften Vertrauensnetzwerk (z. B. 8).
  • Sicherheits-Schnittmenge: Indikator für die mathematische Integrität und Überschneidung des Quorums. Wird bei einem stabilen Zustand als SECURE_OK in Grün ausgegeben.

Unterer Bereich (Footer)

  • System-Status aktuell: Eine grüne Statusbestätigung oben rechts im Footer, die die fehlerfreie Ausführung der GUI signalisiert.
  • Versions-Render: Die programmweit fest verankerte globale Versionsvariable im Footer: Pi-Network Monitor Beta: 0.01.

4. Copyright und Lizenz (LICENSE.md)

Für dieses Projekt gilt die folgende offizielle Lizenzvereinbarung:

Plaintext

MIT License

Copyright (c) 2026 KSC | by Michael Klissner

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

5. Unterstützung & Spendenlinks

Wenn Ihnen der Pi-Node Monitor hilft und Sie die kontinuierliche Weiterentwicklung der Beta-Phase unterstützen möchten, freuen wir uns über eine freiwillige Zuwendung:

Vielen Dank für Ihren Beitrag zum Erhalt stabiler und transparenter Node-Infrastrukturen!

Spenden Bild

Link zur Unterstützung / Spende für den Kanal
Wenn meine Beiträge hilfreich sind oder dir geholfen haben, würde ich mich über eine Unterstützung sehr freuen 🙏

PayPal Link
Überweisung, Bitcoin und Lightning

#PiNetwork #PiNode #Docker #Blockchain #CryptoMonitoring #Mining