Logs
De POS heeft twee loginterfaces: het Logs-scherm in de app (binnen de POS-applicatie) en de WP Admin Logs-pagina (binnen WordPress). Samen geven ze je een compleet beeld van de POS-activiteit voor debuggen en auditeren.
Logs van de POS-applicatie
Logs openen
Open het Logs-scherm via het navigatiepaneel aan de linkerkant (het hartslagpictogram).
Overzicht van de interface
Zoeken en filteren
- Logs zoeken - Vind specifieke logvermeldingen op basis van de berichtinhoud
- Filter op logniveau - Filter op logniveau (info, warn, error)
- Weergave-instellingen - Configureer de zichtbare kolommen
Logtabel
Elke logvermelding toont:
| Kolom | Beschrijving |
|---|---|
| Time | Wanneer de gebeurtenis plaatsvond |
| Level | Ernst: info (grijs), warn (oranje), error (rood) |
| Message | Voor mensen leesbare beschrijving van de gebeurtenis |
| Context | Uitvouwbare JSON met aanvullende details |
| Code | Foutcode (linkt naar de documentatie) |
Logniveaus
Info (grijs)
Normale handelingen en geslaagde gebeurtenissen:
- "Alle ID's voor producten opgehaald"
- "Nieuwe klanten gesynchroniseerd"
- "Alle ID's voor belastingen opgehaald"
Warning (oranje)
Niet-kritieke problemen die mogelijk aandacht nodig hebben:
- "Kan sessie niet vernieuwen"
- "Nieuwe poging voor synchronisatie"
Error (rood)
Problemen die moeten worden aangepakt:
- "Sorry, je kunt geen resources weergeven" (rechtenprobleem)
- "API-verzoek mislukt"
- "Databasesynchronisatiefout"
Audit (blauw)
Het audit-logniveau registreert databasewijzigingen die door de POS zijn gemaakt en legt de volledige situatie vóór en na elke wijziging vast. Dit is handig om precies bij te houden wat er is gewijzigd en wanneer, bijvoorbeeld tijdens het aanmaken van een bestelling, voorraadaanpassingen of klantupdates.
Auditvermeldingen bevatten:
- Entity type - De resource die werd gewijzigd (bijv. order, product, customer)
- Action - Het type wijziging (create, update, delete)
- Before state - De vorige waarden vóór de wijziging
- After state - De nieuwe waarden na de wijziging
Contextgegevens
Klik op de uitvouwpijl bij een logvermelding om gedetailleerde JSON-context te zien:
{
"total": "6",
"execution_time": "54.79 ms",
"server_load": "[10.51, 10.42, 9.98]"
}
Deze gegevens bevatten:
- Item counts - Hoeveel records werden beïnvloed
- Execution time - Hoe lang de bewerking duurde
- Server load - Prestatiegegevens van de server
- Request/response details - Voor het debuggen van API-problemen
Foutcodes
Veel logvermeldingen bevatten een foutcode (bijv. API02004, DB01001). Deze codes linken rechtstreeks naar de Foutcodes-documentatie, die het volgende biedt:
- Gedetailleerde uitleg over de fout
- Veelvoorkomende oorzaken
- Stappen voor probleemoplossing
Veelvoorkomende logvermeldingen
Synchronisatiehandelingen
[info] Fetched all IDs for products {...} 3 items
[info] Synced new customers {...} 1 item
[info] Fetched all IDs for taxes {...} 3 items
Deze duiden op normale synchronisatieactiviteit. De context toont hoeveel items werden gesynchroniseerd.
Rechtenfouten
[error] Sorry, you cannot list resources {...} API02004
Dit betekent meestal dat de gebruiker geen rechten heeft om toegang te krijgen tot een resource. Controleer de gebruikersrollen in WP Admin > POS > Settings > Access.
Sessieproblemen
[warn] Unable to refresh session {...} API02007
De POS kon de authenticatiesessie niet vernieuwen. Hiervoor moet je mogelijk uit- en weer inloggen.
WP Admin Logs-pagina
De POS-plugin biedt ook een server-side Logs-pagina in het WordPress-beheergedeelte. Deze pagina toont POS-specifieke waarschuwingen en fouten die op de server zijn gelogd, wat kan helpen bij het diagnosticeren van problemen die mogelijk niet in de POS-applicatie zelf verschijnen.
De WP Admin Logs-pagina openen
Navigeer naar WP Admin > POS > Settings, selecteer vervolgens het tabblad Tools en klik op Logs.
Badge voor ongelezen
Het Logs-menu-item toont een badge die ongelezen logvermeldingen aangeeft:
- Rode badge - Er zijn ongelezen vermeldingen op foutniveau
- Oranje badge - Er zijn ongelezen vermeldingen op waarschuwingsniveau (maar geen fouten)
Het bezoeken van de Logs-pagina stelt de ongelezen tellingen opnieuw in. De tellingen worden per gebruiker bijgehouden, dus elke beheerder ziet zijn eigen ongelezen status.
Vermeldingen filteren
Gebruik het niveaufilter om de logvermeldingen te beperken:
- All - Toon alle logvermeldingen
- Errors - Toon alleen vermeldingen op foutniveau
- Warnings - Toon alleen vermeldingen op waarschuwingsniveau
Uitvouwbare vermeldingen
Lange logberichten worden afgekapt na ongeveer 100 tekens. Klik op een vermelding om deze uit te vouwen en het volledige bericht samen met eventuele aanvullende contextgegevens te zien.
Paginering
Logvermeldingen worden server-side gepagineerd. Gebruik de pagineringsbediening om door oudere vermeldingen te navigeren.
Banner voor fatale fouten
Als de server fatal-errors-*.log-bestanden heeft, toont de Logs-pagina een waarschuwingsbanner bovenaan. Deze banner linkt naar WooCommerce > Status > Logs, waar je de volledige fatale-foutlogs kunt bekijken. Fatale fouten zijn doorgaans crashes op PHP-niveau die voorkomen dat de POS-API reageert.
Logs gebruiken voor ondersteuning
Bij het aanvragen van ondersteuning:
- Reproduceer het probleem - Voer de handeling uit die het probleem veroorzaakt
- Controleer de logs - Zoek naar fouten (rood) of waarschuwingen (oranje)
- Vouw de context uit - Verkrijg de volledige JSON-details
- Noteer de foutcode - Vermeld deze in je ondersteuningsverzoek
- Kopieer relevante vermeldingen - Deel de logberichten met context
Prestatiebewaking
Logs bevatten uitvoeringstijd en serverbelastingsgegevens. Als je het volgende opmerkt:
- Hoge uitvoeringstijden - De server is mogelijk overbelast of traag
- Hoge serverbelastingswaarden - Overweeg serveroptimalisatie
- Frequente time-outs - Controleer de netwerkverbinding