Import-Überwachung

Dieses Dokument erklärt, wie Sie die Fahrzeugimport-Pipeline im ADP Car Market Hub-Plugin überwachen, einschliesslich des Lesens von Importergebnissen, des Verständnisses der Statuszähler sowie des Erkennens und Behebens von Importfehlern.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie ein Website-Administrator oder technischer Betreiber sind und bestätigen müssen, dass geplante oder manuelle Importe korrekt ausgeführt werden, verstehen möchten, was die Importzähler bedeuten, oder untersuchen wollen, warum Fahrzeuge nicht wie erwartet erscheinen oder aktualisiert werden.

Übersicht

Jedes Mal, wenn die Import-Pipeline ausgeführt wird – sei es durch WP-Cron, den REST-Cron-Endpunkt oder die Schaltfläche Import jetzt ausführen –, zeichnet das Plugin das Ergebnis in der WordPress-Optionstabelle auf und schreibt eine Zusammenfassung in die Logdatei. Diese Informationen werden im Tab Dashboard (KPI-Zeile und letzte Aktivitäten), im Tab Automatisierung (letzte Laufzeit und Status) und im Tab Logs (Details pro Fahrzeug, wenn die ausführliche Protokollierung aktiviert ist) angezeigt.

Anforderungen

• Administrator-Konto mit der Berechtigung manage_as24_imports.
• Die AutoScout24-API-Zugangsdaten und mindestens eine konfigurierte Seller ID unter ADP Car Market Hub → Einstellungen.
• Automatischer Import aktiviert oder ein manueller Import ausgelöst.

Statuszähler des Importlaufs

Nach jedem Importlauf zeichnet das Plugin die folgenden Zähler auf:

Ein fehlerfreier Importlauf bei einem stabilen Katalog zeigt normalerweise einen hohen Wert bei skipped und niedrige oder keine Werte bei inserted, updated und errors. Wenn sich Angebote geändert haben, erhöht sich updated entsprechend.

Importstatus im Admin-Bereich anzeigen

Dashboard-Tab

1. Öffnen Sie ADP Car Market Hub → Dashboard.
2. Die KPI-Zeile zeigt: - Gesamtzahl der importierten Fahrzeuge (veröffentlicht und Entwurf) - Neue Fahrzeuge, die in den letzten 7 Tagen hinzugefügt wurden - Den Zeitstempel des jüngsten Importlaufs
3. Die Diagramme zum Bestandstrend und Kundeninteresse zeigen die historische Aktivität über ausgewählte Zeiträume.
4. Die Dashboard-Daten werden für 3 Minuten zwischengespeichert. Warten Sie nach einem manuellen Import eine kurze Zeit, bevor Sie die Anzeige prüfen.

Import & Limits-Tab

1. Öffnen Sie ADP Car Market Hub → Import & Limits.
2. Die Zeile Letzter Lauf zeigt den Zeitstempel des am kürzesten zurückliegenden abgeschlossenen Imports.
3. Die Zeile Status des letzten Laufs zeigt die Zähler des jüngsten Laufs: eingefügt, aktualisiert, übersprungen, Fehler.
4. Die Zeile Zeitplan zeigt die aktuelle WP-Cron- oder Server-Cron-Konfiguration.
5. Verwenden Sie die Schaltfläche Import jetzt auslösen, um sofort einen Import auszuführen und das Ergebnis zu beobachten.

Logs-Tab

1. Öffnen Sie ADP Car Market Hub → Logs.
2. Die Bereiche Letzte Fehler und Letzte Warnungen zeigen die letzten 50 Fehler- oder Warnungseinträge aus dem Log, wobei die neuesten 2'000 Zeilen durchsucht werden.
3. Bei aktivierter ausführlicher Protokollierung zeigt der Log-Viewer eine Zeile für jedes verarbeitete Fahrzeug: `` [INFO] Import vehicle {listing_id} (seller {seller_id}) begin. [INFO] Import vehicle {listing_id} result=updated. ``
4. Ein abgeschlossener Importlauf erzeugt eine Zusammenfassungszeile: `` [INFO] Import runner (wp-cron) finished: inserted=X updated=X skipped=X errors=X ``

System & Help-Tab — Hintergrundaufgaben

1. Öffnen Sie ADP Car Market Hub → System & Help.
2. Die Tabelle Hintergrundaufgaben zeigt den Hook des Import-Jobs (as24ci_scheduled_import), dessen Zeitplan, die nächste Ausführungszeit und den aktuellen Sperrstatus (Lock-Status).
3. Status-Badges signalisieren: - Geplant (grün) – das Import-Ereignis ist in WP-Cron eingereiht - Wird ausgeführt (gelb) – die Importsperre ist derzeit aktiv - Sperre blockiert (rot) – eine veraltete Sperre wurde erkannt; sie wird beim nächsten Ausführungsversuch automatisch gelöscht - Nicht geplant (gelb) – das Import-Cron-Ereignis ist nicht registriert; prüfen Sie die Automatisierungseinstellungen - Verwaltet durch Server-Cron (grün) – der Server-Cron-Modus ist aktiv

Die Importsperre verstehen

Das Plugin verwendet eine temporäre Sperre (Transient Lock, as24ci_cron_import_running), um überschneidende Importläufe zu verhindern. Die Sperre speichert den Unix-Zeitstempel des Startzeitpunkts und läuft nach 40 Minuten ab.

Wenn ein Importlauf startet, während die Sperre aktiv und noch nicht veraltet ist, wird der neue Lauf übersprungen und die folgende Meldung in das Log geschrieben:

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

Wenn die Sperre älter als 40 Minuten ist (was darauf hindeutet, dass der vorherige Lauf abgebrochen wurde, ohne sie freizugeben), wird die Sperre automatisch gelöscht und ein neuer Lauf fortgesetzt:

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

Im normalen Betrieb müssen Sie diese Sperre nicht manuell löschen.

Maximale Anzahl Fahrzeuge pro Durchlauf

Wenn die Einstellung Max. Fahrzeuge pro Durchlauf auf einen Wert ungleich Null konfiguriert ist, stoppt der Import-Prozess, sobald diese Anzahl an eingefügten oder aktualisierten Fahrzeugen verarbeitet wurde. Übersprungene Fahrzeuge (solche ohne Änderungen) zählen nicht für dieses Limit. Wenn das Limit erreicht ist, protokolliert das Log:

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

Der nächste geplante Lauf wird mit den verbleibenden Angeboten fortgesetzt. Diese Einstellung ist für Umgebungen mit strengen Laufzeitbeschränkungen gedacht.

Full Sync-Überwachung

Wenn Full Sync aktiviert ist, führt der Import-Prozess nach dem regulären Import einen zusätzlichen Durchgang aus: Er vergleicht alle lokal importierten Fahrzeug-Beitrags-IDs mit den von der API zurückgegebenen aktiven Angebots-IDs und löscht alle lokalen Beiträge dauerhaft, deren Angebots-IDs nicht mehr vorhanden sind.

Das Ergebnis des Full Sync wird protokolliert:

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

Achtung: Full Sync wird nicht ausgeführt, wenn das Fahrzeuglimit während des Imports erreicht wurde, da der Remote-Angebotsbestand unvollständig sein könnte. Dies ist eine Sicherheitsmassnahme, um ein versehentliches Massenlöschen zu verhindern, falls die API ein unvollständiges Ergebnis zurückgegeben hat.

Full Sync wird übersprungen (mit einem Hinweis im Log), wenn der Remote-Angebotsbestand leer ist.

API-Konnektivität überwachen

1. Öffnen Sie ADP Car Market Hub → System & Help.
2. Die Karte Konnektivität & API zeigt: - Ob die API-Basis-URL konfiguriert und erreichbar ist (HTTP-Antwortcode und Latenz) - Ob ein gültiges OAuth-Token zwischengespeichert ist und dessen Ablaufzeit - Ob der REST-Cron-Endpunkt erreichbar ist (falls ein Cron-Token konfiguriert wurde) - Ob die Market Hub-API erreichbar ist

Wenn die API während eines Imports nicht erreichbar ist, werden Fehler pro Angebot protokolliert und im Zähler errors erfasst.

Konfigurationsreferenz

Betriebliche Hinweise

• Der Import-Prozess schreibt nach jedem Lauf den letzten Ausführungszeitstempel in as24ci_last_run_time und die Statuszähler in as24ci_last_run_status in der WordPress-Optionstabelle.
• Der Dashboard-Tab liest aus einem temporären Cache mit einer Gültigkeit (TTL) von 3 Minuten. Unmittelbar nach einem manuellen Import spiegeln die angezeigten Zahlen den neuesten Lauf möglicherweise noch nicht wider.
• Der Zähler api_active spiegelt die Anzahl der Angebote wider, die den clientseitigen Filter des Plugins bestanden haben (Status = activated, live = true). Diese Zahl kann niedriger sein als die von der API gemeldete Gesamtzahl, da das Plugin inaktive und nicht live geschaltete Angebote vor dem Import herausfiltert.
• Das Plugin versucht, das PHP-Ausführungszeitlimit zu Beginn jedes durch WP-Cron oder REST ausgelösten Imports auf 300 Sekunden zu erhöhen. Wenn Ihre Hosting-Umgebung dies nicht zulässt, kann es bei Importen grosser Kataloge zu Zeitüberschreitungen kommen. Der System & Help-Tab zeigt ein Badge für den aktuellen Wert von max_execution_time.
• Bei WordPress-Multisite-Installationen hat jede Website im Netzwerk ihre eigene Seller ID-Konfiguration und ihren eigenen Importverlauf.

Fehlerbehebung

Verwandte Dokumente

• Protokollierung und Überwachung
• Wartung der Bildwarteschlange
• Tägliche Arbeitsabläufe
• Wöchentliche Wartung