> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Fehlerbehebung

> Häufige Probleme, Diagnose und Lösungsverfahren

Dieser Leitfaden beschreibt häufige Probleme, die Non-Validator-Nodes betreffen, mit praktischen Diagnosen und Lösungsschritten. Schnelle Fehlerbehebung ist entscheidend, um die RPC-Verfügbarkeit und den zuverlässigen Zugriff auf Stablecoin-Transaktionsdaten aufrechtzuerhalten.

<Note>
  Die meisten Probleme entstehen durch Systemressourcengrenzen, Netzwerkkonnektivität mit Konsens-Endpunkten oder Fehlkonfiguration. Beginnen Sie immer mit grundlegenden Health-Checks, bevor Sie Plasma-spezifische Sonderfälle untersuchen.
</Note>

## Synchronisierungsprobleme

<AccordionGroup>
  <Accordion title="Node hinkt hinterher">
    Wenn Ihr Node hinter den Netzwerk-Head zurückfällt:

    * **Systemlast prüfen**: CPU, Speicher und I/O müssen für Plasmas Hochfrequenz-Blockproduktion ausreichend sein.
    * **Latenz zu Konsens-Endpunkten überprüfen**: Hohe Latenz beeinträchtigt die Block-Ingestionsgeschwindigkeit.
    * **Datenbank-Performance überwachen**: Langsame Queries oder Lock-Contention können die Sync verlangsamen.

    **Diagnose:** Prüfen Sie `block_height` vs. Netzwerk-Head, State-Anwendungszeit pro Block und Latenz zu jedem Konsens-Endpunkt.
  </Accordion>

  <Accordion title="Sync bleibt vollständig stehen">
    Wenn die Synchronisierung anhält:

    * **Speicherplatz prüfen**: Volle Festplatten stoppen Datenbankschreibvorgänge.
    * **Endpunktkonnektivität überprüfen**: Stellen Sie sicher, dass DNS-Auflösung, Firewall-Regeln und Routing den Konsensverkehr nicht blockieren.
    * **Container-Ressourcenlimits prüfen**: Unzureichender Speicher oder CPU können Sync-Prozesse zum Absturz bringen.

    **Plasma-spezifische Prüfungen:** Erreichbarkeit der Endpunkte, gültige JWT-Tokens / Allowlist-Status und Versionskompatibilität des Non-Validator-Nodes überprüfen.
  </Accordion>

  <Accordion title="Schlechte Peer-Konnektivität">
    Begrenzte oder instabile Verbindungen zu Konsens-Endpunkten reduzieren die Datenaktualität für RPC-Konsumenten.

    **Prüfen:** IP-Beschränkungen oder Routing-Richtlinien, Verbindungsanzahl und Uptime der Endpunkte sowie Failover-Verhalten über mehrere Endpunkte hinweg.

    **Schlüsselmetriken:** Aktive Verbindungen, Disconnect-Rate und Lag bei Blockankunft.
  </Accordion>
</AccordionGroup>

## Netzwerkkonnektivität

### Port- und Firewall-Zugang

Stellen Sie sicher, dass die erforderlichen Ports offen sind für:

* **Konsenskommunikation**
* **RPC-Bereitstellung für Anwendungen**

Häufige Blocker sind Unternehmens-Firewalls, Cloud-Sicherheitsgruppen oder fehlkonfigurierte iptables-Regeln.

**Überprüfen:**

* Port-Erreichbarkeit von außerhalb und innerhalb des Containers
* Erlaubter ausgehender Verkehr für Konsens-Sync

### DNS-Fehler

Nicht aufgelöste Konsens-Domains brechen die Sync.

* Bestätigen Sie die DNS-Auflösung für alle Plasma-Service-Domains
* Überwachen Sie Resolver-Latenz und -Zuverlässigkeit
* Fügen Sie bei Bedarf Fallback-Resolver hinzu

### Proxy- und NAT-Probleme

Komplexe Netzwerkumgebungen (VPNs, Proxys, NATs) können stören:

* Konsens-Sync
* Eingehenden RPC-Zugang

**Validieren:**

* Proxy-Authentifizierungsregeln
* NAT-Portweiterleitung für eingehendes RPC
* Routing-Pfade zur Plasma-Infrastruktur

## Konfigurationsfehler

<AccordionGroup>
  <Accordion title="Ungültige Non-Validator-Konfiguration">
    Startfehler werden oft durch falsche oder fehlende Konsens-Endpunkte, fehlerhaft formatierte URLs oder JWT-Tokens oder veraltete Flags verursacht.

    **Logs prüfen auf:** Konfigurations-Parse-Fehler, Chain-ID-Abweichungen und unbekannte Flags oder Optionen.
  </Accordion>

  <Accordion title="Docker-Probleme">
    Fehlkonfigurierte Container können den Normalbetrieb verhindern.

    **Validieren:** Volume-Mounts für Datenbankpersistenz, Netzwerkzugang innerhalb des Containers, Ressourcenlimits (CPU, Speicher) und Image-Versionskompatibilität.
  </Accordion>

  <Accordion title="Konflikte bei Umgebungsvariablen">
    Konfligierende oder falsch sortierte Umgebungsvariablen können beabsichtigte Einstellungen überschreiben.

    **Überprüfen:** Konsens-Endpunkt-URLs und -Tokens, Netzwerk- und Chain-ID sowie Feature-Flags (z. B. Custom-Gas-Support). Dokumentieren Sie die Nutzung von Umgebungsvariablen, um Drift zwischen Deployments zu vermeiden.
  </Accordion>
</AccordionGroup>

## Ressourcenlimits

### Speicherplatz

Überwachen Sie das Wachstum der Festplattennutzung durch:

* Blockchain-Daten
* Logs und temporäre Dateien

**Bewährte Praktiken:**

* Log-Rotation implementieren
* Bereinigungsjobs planen
* Nutzungsalarme überwachen

### Datei-Deskriptoren

Niedrige ulimits können brechen:

* Konsensverbindungen
* RPC-Sitzungen

Erhöhen Sie die Datei-Deskriptor-Limits über `ulimit`, systemd oder Container-Runtime-Konfigurationen.

## Diagnose

### Log-Analyse

Verwenden Sie Logs, um Folgendes zu verfolgen:

* Sync-Fortschritt
* RPC-Fehler
* Konsenskonnektivität
* Ressourcenbedingte Abstürze

**Bewährte Praktiken:**

* **Konsens-Synchronisierungslogs**: Konnektivität und Sync-Fortschritt mit Plasma verfolgen.
* **Transaktionsverarbeitungslogs**: Transaktionsbearbeitung und Fehler überwachen.
* **RPC-Anforderungslogs**: Anfragemuster und Performance von Zahlungsanwendungen analysieren.
* **Ressourcennutzungslogs**: Engpässe identifizieren, die die Zahlungsverarbeitung beeinträchtigen.

### Performance-Profiling

Profilen Sie Non-Validator-Workloads, um Engpässe zu identifizieren in:

* RPC-Performance
* DB-Query-Latenz
* Konsens-State-Anwendung

**Schwerpunktbereiche:**

* Durchsatz bei Guthabenprüfungen
* Bestätigungslatenz bei Transfers
* Ressourcennutzung unter Last

Pflegen Sie Baselines und verfolgen Sie Änderungen über Upgrades oder Konfigurationsänderungen hinweg.

Systematische Fehlerbehebung und Observability sind essenziell für den zuverlässigen Betrieb von Non-Validator-Nodes. Ordnungsgemäße Diagnose, Logging und Konfigurations-Hygiene gewährleisten stabile Performance und Uptime für RPC-Dienste, die Stablecoin-Infrastruktur unterstützen.