Protokolle

Das POS verfügt über zwei Protokolloberflächen: den In-App-Protokollbildschirm (innerhalb der POS-Anwendung) und die WP-Admin-Protokollseite (innerhalb von WordPress). Zusammen liefern sie Ihnen ein vollständiges Bild der POS-Aktivität für Debugging und Auditing.

POS-Anwendungsprotokolle

Zugriff auf Protokolle

Öffnen Sie den Protokollbildschirm über das linke Navigationsmenü (das Herzschlagsymbol).

Übersicht der Benutzeroberfläche

Suchen & Filtern

• Protokolle durchsuchen - Bestimmte Protokolleinträge nach Nachrichteninhalt finden
• Protokollebenen-Filter - Nach Protokollebene filtern (info, warn, error)
• Anzeigeeinstellungen - Sichtbare Spalten konfigurieren

Protokolltabelle

Jeder Protokolleintrag zeigt:

Spalte	Beschreibung
Zeit	Wann das Ereignis aufgetreten ist
Ebene	Schweregrad: info (grau), warn (orange), error (rot)
Nachricht	Menschlich lesbare Beschreibung des Ereignisses
Kontext	Erweiterbares JSON mit zusätzlichen Details
Code	Fehlercode (verlinkt zur Dokumentation)

Protokollebenen

Info (Grau)

Normale Vorgänge und erfolgreiche Ereignisse:

• „Alle IDs für Produkte abgerufen"
• „Neue Kunden synchronisiert"
• „Alle IDs für Steuern abgerufen"

Warnung (Orange)

Nicht kritische Probleme, die möglicherweise Aufmerksamkeit erfordern:

• „Sitzung konnte nicht aktualisiert werden"
• „Wiederholungsversuch für Sync"

Fehler (Rot)

Probleme, die behoben werden müssen:

• „Entschuldigung, Sie können Ressourcen nicht auflisten" (Berechtigungsproblem)
• „API-Anforderung fehlgeschlagen"
• „Datenbank-Synchronisierungsfehler"

Audit (Blau)

Die Audit-Protokollebene zeichnet Datenbankänderungen auf, die vom POS vorgenommen wurden, und erfasst den vollständigen Zustand vor und nach jeder Änderung. Dies ist nützlich, um genau nachzuverfolgen, was sich wann geändert hat, zum Beispiel bei der Bestellerstellung, bei Bestandsanpassungen oder bei Kundenaktualisierungen.

Audit-Einträge umfassen:

• Entitätstyp - Die geänderte Ressource (z. B. Bestellung, Produkt, Kunde)
• Aktion - Die Art der Änderung (erstellen, aktualisieren, löschen)
• Vorheriger Zustand - Die vorherigen Werte vor der Änderung
• Neuer Zustand - Die neuen Werte nach der Änderung

Kontextdaten

Klicken Sie auf den Erweitern-Pfeil bei einem beliebigen Protokolleintrag, um den detaillierten JSON-Kontext anzuzeigen:

{
  "total": "6",
  "execution_time": "54.79 ms",
  "server_load": "[10.51, 10.42, 9.98]"
}

Diese Daten enthalten:

• Postenanzahl - Wie viele Datensätze betroffen waren
• Ausführungszeit - Wie lange der Vorgang gedauert hat
• Serverauslastung - Leistungskennzahlen des Servers
• Anforderungs-/Antwortdetails - Zur Fehlersuche bei API-Problemen

Fehlercodes

Viele Protokolleinträge enthalten einen Fehlercode (z. B. API02004, DB01001). Diese Codes verlinken direkt zur Fehlercodes-Dokumentation, die Folgendes bietet:

• Detaillierte Erklärung des Fehlers
• Häufige Ursachen
• Schritte zur Fehlerbehebung

Häufige Protokolleinträge

Synchronisationsvorgänge

[info] Fetched all IDs for products    {...} 3 items
[info] Synced new customers            {...} 1 item
[info] Fetched all IDs for taxes       {...} 3 items

Diese zeigen normale Synchronisationsaktivitäten an. Der Kontext zeigt, wie viele Elemente synchronisiert wurden.

Berechtigungsfehler

[error] Sorry, you cannot list resources    {...} API02004

Dies bedeutet normalerweise, dass der Benutzer nicht über die Berechtigung verfügt, auf eine Ressource zuzugreifen. Überprüfen Sie die Benutzerrollen in WP Admin > POS > Settings > Access.

Sitzungsprobleme

[warn] Unable to refresh session    {...} API02007

Das POS konnte die Authentifizierungssitzung nicht aktualisieren. Dies kann erfordern, sich abzumelden und erneut anzumelden.

WP-Admin-Protokollseite

Das POS-Plugin bietet außerdem eine serverseitige Protokollseite im WordPress-Admin-Bereich. Diese Seite zeigt POS-spezifische Warnungen und Fehler, die auf dem Server protokolliert werden, was bei der Diagnose von Problemen helfen kann, die möglicherweise nicht in der POS-Anwendung selbst erscheinen.

Zugriff auf die WP-Admin-Protokollseite

Navigieren Sie zu WP Admin > POS > Settings, wählen Sie dann den Tab Tools und klicken Sie auf Logs.

Ungelesen-Abzeichen

Der Protokoll-Menüpunkt zeigt ein Abzeichen, das ungelesene Protokolleinträge anzeigt:

• Rotes Abzeichen - Es gibt ungelesene Einträge auf Fehlerebene
• Bernsteinfarbenes Abzeichen - Es gibt ungelesene Einträge auf Warnungsebene (aber keine Fehler)

Der Besuch der Protokollseite setzt die Ungelesen-Zähler zurück. Die Zähler werden pro Benutzer verfolgt, sodass jeder Administrator seinen eigenen Ungelesen-Status sieht.

Einträge filtern

Verwenden Sie den Ebenenfilter, um Protokolleinträge einzugrenzen:

• Alle - Alle Protokolleinträge anzeigen
• Fehler - Nur Einträge auf Fehlerebene anzeigen
• Warnungen - Nur Einträge auf Warnungsebene anzeigen

Erweiterbare Einträge

Lange Protokollnachrichten werden bei etwa 100 Zeichen abgeschnitten. Klicken Sie auf einen Eintrag, um ihn zu erweitern und die vollständige Nachricht zusammen mit allen zusätzlichen Kontextdaten anzuzeigen.

Paginierung

Protokolleinträge werden serverseitig paginiert. Verwenden Sie die Paginierungssteuerung, um durch ältere Einträge zu navigieren.

Banner für fatale Fehler

Wenn der Server fatal-errors-*.log-Dateien hat, zeigt die Protokollseite oben ein Warnbanner an. Dieses Banner verlinkt zu WooCommerce > Status > Logs, wo Sie die vollständigen Fatale-Fehler-Protokolle einsehen können. Fatale Fehler sind in der Regel Abstürze auf PHP-Ebene, die verhindern, dass die POS-API antwortet.

Protokolle für den Support verwenden

Bei einer Supportanfrage:

1. Reproduzieren Sie das Problem - Führen Sie die Aktion aus, die das Problem verursacht
2. Überprüfen Sie die Protokolle - Suchen Sie nach Fehlern (rot) oder Warnungen (orange)
3. Erweitern Sie den Kontext - Holen Sie sich die vollständigen JSON-Details
4. Notieren Sie den Fehlercode - Fügen Sie diesen in Ihre Supportanfrage ein
5. Kopieren Sie relevante Einträge - Teilen Sie die Protokollnachrichten mit Kontext

Leistungsüberwachung

Protokolle enthalten Ausführungszeiten und Serverauslastungskennzahlen. Wenn Sie Folgendes feststellen:

• Hohe Ausführungszeiten - Der Server könnte überlastet oder langsam sein
• Hohe Serverauslastungswerte - Erwägen Sie eine Serveroptimierung
• Häufige Timeouts - Überprüfen Sie die Netzwerkverbindung

Verwandte Dokumentation

FehlercodesDetaillierte Fehlererklärungen

FehlerbehebungHäufige Probleme und Lösungen

SupportHilfe erhalten