Importmonitoring

Dit document legt uit hoe u de voertuigimport-pijplijn in de ADP Car Market Hub-plugin kunt monitoren, inclusief het lezen van de resultaten van importruns, het begrijpen van de statusstellers en het identificeren van en reageren op importfouten.

Wanneer u dit document moet gebruiken

Lees dit document als u een sitebeheerder of technisch operator bent die moet controleren of geplande of handmatige imports correct worden uitgevoerd, wil begrijpen wat de importtellers betekenen, of wil onderzoeken waarom voertuigen niet verschijnen of niet worden bijgewerkt zoals verwacht.

Overzicht

Elke keer dat de import-pijplijn wordt uitgevoerd — of deze nu wordt geactiveerd door WP-Cron, het REST-cron-endpoint of de knop Nu import uitvoeren — registreert de plugin het resultaat in de WordPress-optietabel en schrijft een samenvatting naar het logbestand. Deze informatie wordt weergegeven op het tabblad Dashboard (KPI-rij en recente activiteit), het tabblad Automatisering (tijdstip en status van de laatste run) en het tabblad Logs (details per voertuig wanneer gedetailleerde logboekregistratie is ingeschakeld).

Systeemvereisten

• Beheerdersaccount met de manage_as24_imports-bevoegdheid.
• De AutoScout24-API-inloggegevens en ten minste één Seller ID geconfigureerd onder ADP Car Market Hub → Instellingen.
• Automatische import ingeschakeld of een handmatige import geactiveerd.

Statusstellers van de importrun

Na elke importrun registreert de plugin de volgende tellers:

Een gezonde importrun op een stabiele catalogus toont doorgaans een hoog aantal voor skipped en een laag aantal of nul voor inserted, updated en errors. Als advertenties zijn gewijzigd, zal updated dienovereenkomstig toenemen.

Importstatus bekijken in de beheeromgeving

Tabblad Dashboard

1. Open ADP Car Market Hub → Dashboard.
2. De KPI-rij toont: - Totaal geïmporteerde voertuigen (gepubliceerd en concept) - Nieuwe voertuigen toegevoegd in de afgelopen 7 dagen - De tijdstempel van de meest recente importrun
3. De grafieken voor voorraadtrend en klantinteresse tonen historische activiteit over geselecteerde tijdsperioden.
4. Dashboardgegevens worden 3 minuten gecached. Wacht even na een handmatige import voordat u controleert.

Tabblad Import & Limieten

1. Open ADP Car Market Hub → Import & Limieten.
2. De rij Laatste run toont de tijdstempel van de meest recent voltooide import.
3. De rij Status laatste run toont de tellers van de meest recente run: toegevoegd, bijgewerkt, overgeslagen, fouten.
4. De rij Schema toont de huidige WP-Cron- of server-cron-configuratie.
5. Gebruik de knop Nu import starten om direct een import uit te voeren en het resultaat te bekijken.

Tabblad Logs

1. Open ADP Car Market Hub → Logs.
2. De panelen Recente fouten and Recente waarschuwingen tonen de laatste 50 fouten of waarschuwingen uit het logboek, waarbij de meest recente 2.000 regels worden gescand.
3. Als gedetailleerde logboekregistratie is ingeschakeld, toont de Log Viewer een regel voor elk verwerkt voertuig: `` [INFO] Import vehicle {listing_id} (seller {seller_id}) begin. [INFO] Import vehicle {listing_id} result=updated. ``
4. Een voltooide importrun genereert een samenvattingsregel: `` [INFO] Import runner (wp-cron) finished: inserted=X updated=X skipped=X errors=X ``

Tabblad Systeem & Help — Achtergrondtaken

1. Open ADP Car Market Hub → Systeem & Help.
2. De tabel Achtergrondtaken toont de importtaak-hook (as24ci_scheduled_import), het schema, de volgende uitvoeringstijd en de huidige lock-status.
3. Statusbadges geven aan: - Gepland (groen) — de importtaak staat in de wachtrij van WP-Cron - Actief (oranje) — de import-lock is momenteel actief - Lock vastgelopen (rood) — er is een verouderde lock gedetecteerd; deze wordt automatisch gewist bij de volgende startpoging - Niet gepland (oranje) — de import-cron-taak is niet geregistreerd; controleer de automatiseringsinstellingen - Afgehandeld door server-cron (groen) — server-cron-modus is actief

De import-lock begrijpen

De plugin gebruikt een tijdelijke lock (as24ci_cron_import_running) om overlappende importruns te voorkomen. De lock slaat de Unix-tijdstempel op van wanneer de run is gestart en verloopt na 40 minuten.

Als een importrun start terwijl de lock actief is en de lock is niet verouderd, wordt de nieuwe run overgeslagen en wordt de volgende melding naar het logboek geschreven:

[INFO] Import runner (wp-cron): already in progress, skipping.

Als de lock ouder is dan 40 minuten (wat erop wijst dat de vorige run is vastgelopen zonder de lock vrij te geven), wordt de lock automatisch gewist en wordt er een nieuwe run gestart:

[INFO] Import runner (wp-cron): stale lock detected (age=Xs), clearing and proceeding.

U hoeft deze lock bij normaal gebruik niet handmatig te wissen.

Max. voertuigen per run

Wanneer de instelling Max. voertuigen per run is geconfigureerd met een waarde anders dan nul, stopt de import-uitvoerder na het verwerken van dat aantal toegevoegde of bijgewerkte voertuigen. Overgeslagen voertuigen (voertuigen zonder wijzigingen) tellen niet mee voor deze limiet. Wanneer de limiet is bereikt, registreert het logboek:

[INFO] Import runner (wp-cron): vehicle limit (N) reached, stopping. inserted=X updated=X skipped=X errors=X

De volgende geplande run gaat verder met de resterende advertenties. Deze instelling is bedoeld voor omgevingen met strikte limieten voor de uitvoeringstijd.

Volledige synchronisatie monitoren

Wanneer Volledige synchronisatie is ingeschakeld, voert de import-uitvoerder een extra stap uit na de reguliere import: deze vergelijkt alle lokaal geïmporteerde voertuigbericht-ID's met de set actieve advertentie-ID's die door de API zijn geretourneerd, en verwijdert permanent alle lokale berichten waarvan de advertentie-ID's niet langer aanwezig zijn.

Het resultaat van de volledige synchronisatie wordt gelogd:

[INFO] Full sync completed: kept=X deleted=X.

Let op: Volledige synchronisatie wordt niet uitgevoerd als de voertuigliemiet is bereikt tijdens de import, omdat de externe advertentieset dan mogelijk onvolledig is. Dit is een veiligheidsmaatregel om onbedoelde massale verwijdering te voorkomen wanneer de API een gedeeltelijk resultaat heeft geretourneerd.

Volledige synchronisatie wordt overgeslagen (met een melding in het logboek) als de externe advertentieset leeg is.

API-connectiviteit monitoren

1. Open ADP Car Market Hub → Systeem & Help.
2. De kaart Connectiviteit & API toont: - Of de API-basis-URL is geconfigureerd en bereikbaar is (HTTP-responscode en latentie) - Of er een geldig OAuth-token in de cache is opgeslagen en de vervaltijd daarvan - Of het REST-cron-endpoint bereikbaar is (als er een cron-token is geconfigureerd) - Of de Market Hub API bereikbaar is

Als de API onbereikbaar is tijdens een import, worden er fouten gelogd per advertentie en geteld in de errors-teller.

Configuratiereferentie

Operationele opmerkingen

• De import-uitvoerder schrijft na elke run de tijdstempel van de laatste run naar as24ci_last_run_time en de statusstellers naar as24ci_last_run_status in de WordPress-optietabel.
• Het tabblad Dashboard leest uit een tijdelijke cache met een TTL van 3 minuten. Direct na een handmatige import weerspiegelen de weergegeven aantallen mogelijk nog niet de nieuwste run.
• De api_active-teller weerspiegelt het aantal advertenties dat door het client-side filter van de plugin is gekomen (status = activated, live = true). Dit aantal kan lager zijn dan het ruwe totaal dat door de API wordt gerapporteerd, omdat de plugin inactieve en niet-live advertenties filtert vóór het importeren.
• De plugin probeert de PHP-uitvoeringstijdlimiet te verhogen naar 300 seconden aan het begin van elke door WP-Cron of REST geactiveerde import. Als uw hostingomgeving dit niet toestaat, kunnen imports van grote catalogi vastlopen. Het tabblad Systeem & Help toont een badge voor de huidige max_execution_time-waarde.
• Op WordPress multisite-installaties heeft elke site in het netwerk zijn eigen Seller ID-configuratie en zijn eigen importgeschiedenis.

Problemen oplossen

Gerelateerde documenten

• Logboekregistratie en monitoring
• Onderhoud van de afbeeldingswachtrij
• Dagelijks beheer
• Wekelijks onderhoud