Zum Hauptinhalt springen
Version: 1.x

Protokolle

Der Bildschirm „Protokolle“ zeichnet die Systemaktivität innerhalb des POS auf. Es ist ein wichtiges Werkzeug zur Fehlersuche und zum Verständnis dessen, was im Hintergrund passiert.

Zugriff auf Protokolle​

Öffnen Sie den Bildschirm „Protokolle“ über das linke Navigationsmenü (das Herzsymbol).

Übersicht der Benutzeroberfläche​

Suchen & Filtern​

  • Protokolle durchsuchen - Bestimmte Protokolleinträge nach Nachrichteninhalt suchen
  • Protokollebene filtern - Nach Protokollebene filtern (info, warn, error)
  • Anzeigeneinstellungen - Sichtbare Spalten konfigurieren

Protokolltabelle​

Jeder Protokolleintrag zeigt:

SpalteBeschreibung
ZeitWann das Ereignis aufgetreten ist
EbeneSchweregrad: info (grau), warn (orange), error (rot)
NachrichtMenschlich lesbare Beschreibung des Ereignisses
KontextErweitertes JSON mit zusätzlichen Details
CodeFehlercode (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“

Kontextdaten​

Klicken Sie auf den Erweitern-Pfeil bei einem 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 > Einstellungen > Zugriff.

Sitzungsprobleme​

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

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

Verwendung von Protokollen für den Support​

Bei der Anfrage um Support:

  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
FehlercodesDetaillierte Fehlererklärungen
FehlerbehebungHäufige Probleme und Lösungen
SupportHilfe erhalten