# 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[​](#pos-application-logs "Direkter Link zu POS-Anwendungsprotokolle")

### Zugriff auf Protokolle[​](#accessing-logs "Direkter Link zu Zugriff auf Protokolle")

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

### Übersicht der Benutzeroberfläche[​](#interface-overview "Direkter Link zu Übersicht der Benutzeroberfläche")

#### Suchen & Filtern[​](#search--filter "Direkter Link zu Suchen & Filtern")

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

#### Protokolltabelle[​](#log-table "Direkter Link zu 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[​](#log-levels "Direkter Link zu Protokollebenen")

#### Info (Grau)[​](#info-grey "Direkter Link zu 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)[​](#warning-orange "Direkter Link zu Warnung (Orange)")

Nicht kritische Probleme, die möglicherweise Aufmerksamkeit erfordern:

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

#### Fehler (Rot)[​](#error-red "Direkter Link zu Fehler (Rot)")

Probleme, die behoben werden müssen:

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

#### Audit (Blau)[​](#audit-blue "Direkter Link zu 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[​](#context-data "Direkter Link zu 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[​](#error-codes "Direkter Link zu Fehlercodes")

Viele Protokolleinträge enthalten einen **Fehlercode** (z. B. `API02004`, `DB01001`). Diese Codes verlinken direkt zur [Fehlercodes](/de/error-codes/.md)-Dokumentation, die Folgendes bietet:

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

### Häufige Protokolleinträge[​](#common-log-entries "Direkter Link zu Häufige Protokolleinträge")

#### Synchronisationsvorgänge[​](#sync-operations "Direkter Link zu 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[​](#permission-errors "Direkter Link zu 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[​](#session-issues "Direkter Link zu 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[​](#wp-admin-logs-page "Direkter Link zu 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[​](#accessing-the-wp-admin-logs-page "Direkter Link zu 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[​](#unread-badge "Direkter Link zu 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[​](#filtering-entries "Direkter Link zu 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[​](#expandable-entries "Direkter Link zu 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[​](#pagination "Direkter Link zu Paginierung")

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

### Banner für fatale Fehler[​](#fatal-errors-banner "Direkter Link zu 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[​](#using-logs-for-support "Direkter Link zu 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[​](#performance-monitoring "Direkter Link zu 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[​](#related-documentation "Direkter Link zu Verwandte Dokumentation")

[FehlercodesDetaillierte Fehlererklärungen](/de/error-codes/.md)

[FehlerbehebungHäufige Probleme und Lösungen](/de/category/troubleshooting.md)

[SupportHilfe erhalten](/de/support/.md)