Suivi des importations

Ce document explique comment suivre le pipeline d'importation de véhicules dans l'extension ADP Car Market Hub, y compris comment lire les résultats d'exécution d'importation, comprendre les compteurs d'état, et identifier et répondre aux échecs d'importation.

Quand utiliser ce document

Lisez ce document si vous êtes un administrateur de site ou un opérateur technique qui doit confirmer que les importations planifiées ou manuelles s'exécutent correctement, comprendre la signification des compteurs d'importation, ou rechercher pourquoi des véhicules n'apparaissent pas ou ne se mettent pas à jour comme prévu.

Aperçu

Chaque fois que le pipeline d'importation s'exécute — qu'il soit déclenché par WP-Cron, l'endpoint REST cron ou le bouton Lancer l'importation maintenant — l'extension enregistre le résultat dans la table des options WordPress et écrit un résumé dans le fichier journal. Ces informations sont affichées dans l'onglet Tableau de bord (ligne KPI et activité récente), l'onglet Automatisation (heure et état de la dernière exécution) et l'onglet Journaux (détails par véhicule lorsque la journalisation détaillée est activée).

Configuration requise

• Compte administrateur avec la capacité manage_as24_imports.
• Les identifiants API AutoScout24 et au moins un Seller ID configuré sous ADP Car Market Hub → Réglages.
• Importation automatique activée ou une importation manuelle déclenchée.

Compteurs d'état d'exécution d'importation

Après chaque exécution d'importation, l'extension enregistre les compteurs suivants :

Une exécution d'importation saine sur un catalogue stable affichera généralement un compteur skipped élevé et des compteurs inserted, updated et errors faibles ou nuls. Si des annonces ont changé, updated augmentera en conséquence.

Visualisation de l'état de l'importation dans l'administration

Onglet Tableau de bord

1. Allez dans ADP Car Market Hub → Tableau de bord.
2. La ligne KPI affiche : - Le total des véhicules importés (publiés et brouillons) - Les nouveaux véhicules ajoutés au cours des 7 derniers jours - L'horodatage de l'exécution d'importation la plus récente
3. Les graphiques de tendance de l'inventaire et d'intérêt des clients montrent l'activité historique sur des périodes sélectionnées.
4. Les données du tableau de bord sont mises en cache pendant 3 minutes. Attendez un court instant après une importation manuelle avant de vérifier.

Onglet Importations et limites

1. Allez dans ADP Car Market Hub → Importations et limites.
2. La ligne Dernière exécution indique l'horodatage de la dernière importation terminée.
3. La ligne État de la dernière exécution affiche les compteurs de la dernière exécution : insérés, mis à jour, ignorés, erreurs.
4. La ligne Planification montre la configuration actuelle de WP-Cron ou du cron serveur.
5. Utilisez le bouton Déclencher l'importation maintenant pour lancer une importation immédiate et observer le résultat.

Onglet Journaux

1. Allez dans ADP Car Market Hub → Journaux.
2. Les panneaux Erreurs récentes et Avertissements récents affichent les 50 dernières entrées d'erreur ou d'avertissement du journal, en analysant les 2 000 lignes les plus récentes.
3. Lorsque la journalisation détaillée est activée, le visualiseur de journaux affiche une ligne pour chaque véhicule traité : `` [INFO] Import vehicle {listing_id} (seller {seller_id}) begin. [INFO] Import vehicle {listing_id} result=updated. ``
4. Une exécution d'importation terminée produit une ligne de résumé : `` [INFO] Import runner (wp-cron) finished: inserted=X updated=X skipped=X errors=X ``

Onglet Système et aide — Tâches d'arrière-plan

1. Allez dans ADP Car Market Hub → Système et aide.
2. Le tableau Tâches d'arrière-plan montre le hook de la tâche d'importation (as24ci_scheduled_import), sa planification, l'heure de sa prochaine exécution et l'état actuel du verrouillage.
3. Les badges d'état indiquent : - Planifié (vert) — l'événement d'importation est mis en file d'attente dans WP-Cron - En cours d'exécution (orange) — le verrou d'importation est actuellement actif - Verrou bloqué (rouge) — un verrou obsolète a été détecté ; il sera automatiquement effacé lors de la prochaine tentative d'exécution - Non planifié (orange) — l'événement cron d'importation n'est pas enregistré ; vérifiez les paramètres d'automatisation - Géré par le cron du serveur (vert) — le mode cron du serveur est actif

Comprendre le verrou d'importation

L'extension utilise un verrou temporaire (transient) (as24ci_cron_import_running) pour empêcher les exécutions d'importation de se chevaucher. Le verrou stocke l'horodatage Unix du début de l'exécution et expire après 40 minutes.

Si une exécution d'importation commence alors que le verrou est actif et qu'il n'est pas obsolète, la nouvelle exécution est ignorée et le message suivant est écrit dans le journal :

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

Si le verrou date de plus de 40 minutes (indiquant que l'exécution précédente s'est arrêtée sans le libérer), le verrou est automatiquement effacé et une nouvelle exécution commence :

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

Vous n'avez pas besoin de libérer ce verrou manuellement en fonctionnement normal.

Nombre maximal de véhicules par exécution

Lorsque le paramètre Nombre maximal de véhicules par exécution est configuré sur une valeur non nulle, le lanceur d'importation s'arrête après avoir traité ce nombre de véhicules insérés ou mis à jour. Les véhicules ignorés (ceux sans modifications) ne comptent pas dans cette limite. Lorsque la limite est atteinte, le journal enregistre :

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

La prochaine exécution planifiée continuera avec les annonces restantes. Ce paramètre est destiné aux environnements ayant des contraintes strictes de temps d'exécution.

Suivi de la synchronisation complète

Lorsque la Synchronisation complète est activée, le lanceur d'importation effectue une passe supplémentaire après l'importation normale : il compare tous les ID de publication de véhicules importés localement avec l'ensemble des ID d'annonces actives renvoyés par l'API, et supprime définitivement toutes les publications locales dont les ID d'annonces ne sont plus présents.

Le résultat de la synchronisation complète est consigné dans le journal :

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

Attention : La synchronisation complète ne s'exécutera pas si la limite de véhicules a été atteinte pendant l'importation, car l'ensemble des annonces distantes peut être incomplet. Il s'agit d'une mesure de sécurité pour éviter une suppression massive accidentelle lorsque l'API renvoie un résultat partiel.

La synchronisation complète est ignorée (avec une notification dans le journal) si l'ensemble des annonces distantes est vide.

Suivi de la connectivité API

1. Allez dans ADP Car Market Hub → Système et aide.
2. La carte Connectivité et API affiche : - Si l'URL de base de l'API est configurée et accessible (code de réponse HTTP et latence) - Si un jeton OAuth valide est mis en cache et son heure d'expiration - Si l'endpoint REST cron est accessible (si un jeton cron a été configuré) - Si l'API Market Hub est accessible

Si l'API est inaccessible pendant une importation, les erreurs sont consignées par annonce et comptabilisées dans le compteur errors.

Référence de configuration

Notes opérationnelles

• Le lanceur d'importation écrit l'horodatage de la dernière exécution dans as24ci_last_run_time et les compteurs d'état dans as24ci_last_run_status dans la table des options WordPress après chaque exécution.
• L'onglet Tableau de bord lit à partir d'un cache temporaire avec une durée de vie (TTL) de 3 minutes. Immédiatement après une importation manuelle, les compteurs affichés peuvent ne pas encore refléter la dernière exécution.
• Le compteur api_active reflète le nombre d'annonces qui ont passé le filtre côté client de l'extension (état = activated, live = true). Ce nombre peut être inférieur au total brut signalé par l'API car l'extension filtre les annonces inactives et non en ligne avant l'importation.
• L'extension tente d'augmenter la limite de temps d'exécution PHP à 300 secondes au début de chaque importation déclenchée par WP-Cron ou REST. Si votre environnement d'hébergement ne le permet pas, les importations de grands catalogues peuvent expirer. L'onglet Système et aide affiche un badge pour la valeur actuelle de max_execution_time.
• Sur les installations multisites WordPress, chaque site du réseau a sa propre configuration de Seller ID et son propre historique d'importation.

Dépannage

Documents connexes

• Journalisation et suivi
• Maintenance de la file d'attente des images
• Utilisation quotidienne
• Maintenance hebdomadaire