Import-Überwachung

Dieses Dokument erklärt, wie Sie die Fahrzeug-Import-Pipeline im ADP Car Market Hub-Plugin überwachen, einschließlich des Lesens von Importergebnissen, des Verständnisses der Statuszähler sowie des Erkennens und Reagierens auf Importfehler.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie ein Website-Administrator oder technischer Betreiber sind, der bestätigen muss, dass geplante oder manuelle Importe korrekt ausgeführt werden, die Bedeutung der Importzähler verstehen möchte oder untersuchen muss, 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 Jetzt Import ausführen –, zeichnet das Plugin das Ergebnis in der WordPress-Optionstabelle auf und schreibt eine Zusammenfassung in die Protokolldatei. Diese Informationen werden im Tab Dashboard (KPI-Zeile und letzte Aktivitäten), im Tab Automatisierung (letzte Laufzeit und Status) und im Tab Protokolle (Details pro Fahrzeug bei aktiviertem ausführlichen Protokoll) angezeigt.

Voraussetzungen

• 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 typischerweise einen hohen Wert für skipped und niedrige oder keine Werte für 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. Dashboard-Daten werden für 3 Minuten zwischengespeichert. Warten Sie nach einem manuellen Import eine kurze Zeit, bevor Sie die Anzeige prüfen.

Tab „Import & Limits“

1. Öffnen Sie ADP Car Market Hub → Import & Limits.
2. Die Zeile Letzter Lauf zeigt den Zeitstempel des zuletzt 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.

Tab „Protokolle“

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 Protokoll und scannen dabei die neuesten 2.000 Zeilen.
3. Bei aktiviertem ausführlichen Protokoll 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 ``

Tab „System & Hilfe“ — Hintergrundaufgaben

1. Öffnen Sie ADP Car Market Hub → System & Help.
2. Die Tabelle Hintergrundaufgaben zeigt den Import-Job-Hook (as24ci_scheduled_import), seinen Zeitplan, die nächste Ausführungszeit und den aktuellen Sperrstatus.
3. Status-Badges zeigen Folgendes an: - 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; überprüfen Sie die Automatisierungseinstellungen - Wird über Server-Cron verarbeitet (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 Starts und läuft nach 40 Minuten ab.

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

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

Wenn die Sperre älter als 40 minutes 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 Fahrzeuge pro Lauf

Wenn die Einstellung Max. Fahrzeuge pro Lauf auf einen Wert ungleich Null konfiguriert ist, stoppt der Import-Runner, nachdem 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 System:

[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-Runner nach dem regulären Import einen zusätzlichen Durchlauf durch: Er vergleicht alle lokal importierten Fahrzeug-Beitrags-IDs mit den von der API zurückgegebenen aktiven Angebots-IDs und löscht dauerhaft alle lokalen Beiträge, 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 Sicherheitsmaßnahme, um ein versehentliches Massenlöschen zu verhindern, falls die API ein unvollständiges Ergebnis zurückgegeben hat.

Full Sync wird übersprungen (mit einem Protokollhinweis), 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

Betriebshinweise

• Der Import-Runner 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 transienten Cache mit einer TTL von 3 Minuten. Unmittelbar nach einem manuellen Import spiegeln die angezeigten Zahlen möglicherweise noch nicht den neuesten Lauf 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 Bruttosumme, da das Plugin inaktive und nicht live geschaltete Angebote vor dem Import herausfiltert.
• Das Plugin versucht, das PHP-Auszeitlimit zu Beginn jedes 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 großer Kataloge zu Zeitüberschreitungen kommen. Der Tab „System & Hilfe“ zeigt ein Badge für den aktuellen max_execution_time-Wert.
• Bei WordPress-Multisite-Installationen hat jede Website im Netzwerk ihre eigene Seller ID-Konfiguration und ihren eigenen Importhistorie.

Fehlerbehebung

Zugehörige Dokumente

• Protokollierung und Überwachung
• Wartung der Bildwarteschlange
• Täglicher Betrieb
• Wöchentliche Wartung