Monitoraggio dell'importazione

Questo documento spiega come monitorare la pipeline di importazione dei veicoli nel plugin ADP Car Market Hub, incluso come leggere i risultati dell'esecuzione dell'importazione, comprendere i contatori di stato e identificare e rispondere ai fallimenti di importazione.

Quando usare questo documento

Leggi questo documento se sei un amministratore del sito o un operatore tecnico che ha bisogno di confermare che le importazioni pianificate o manuali vengano eseguite correttamente, capire cosa significano i contatori di importazione o verificare perché i veicoli non appaiono o non si aggiornano come previsto.

Panoramica

Ogni volta che la pipeline di importazione viene eseguita — sia essa attivata da WP-Cron, dall'endpoint REST cron o dal pulsante Esegui importazione ora — il plugin registra il risultato nella tabella delle opzioni WordPress e scrive un riepilogo nel file di log. Queste informazioni vengono mostrate nella scheda Dashboard (riga KPI e attività recente), nella scheda Automazione (ora dell'ultima esecuzione e stato) e nella scheda Logs (dettaglio per singolo veicolo quando la registrazione dettagliata è attiva).

Requisiti

• Account amministratore con la funzionalità manage_as24_imports.
• Credenziali API AutoScout24 e almeno un Seller ID configurato in ADP Car Market Hub → Impostazioni.
• Importazione automatica abilitata o un'importazione manuale avviata.

Contatori di stato dell'esecuzione dell'importazione

Dopo ogni esecuzione dell'importazione, il plugin registra i seguenti contatori:

Un'esecuzione di importazione corretta su un catalogo stabile mostrerà in genere un conteggio elevato di skipped e un valore basso o pari a zero per inserted, updated e errors. Se gli annunci sono cambiati, updated aumenterà di conseguenza.

Visualizzazione dello stato dell'importazione nell'amministrazione

Scheda Dashboard

1. Apri ADP Car Market Hub → Dashboard.
2. La riga KPI mostra: - Veicoli totali importati (pubblicati e in bozza) - Nuovi veicoli aggiunti negli ultimi 7 giorni - Il timestamp dell'esecuzione dell'importazione più recente
3. I grafici sull'andamento dell'inventario e sull'interesse dei clienti mostrano l'attività storica nei periodi di tempo selezionati.
4. I dati della Dashboard sono memorizzati nella cache per 3 minuti. Attendi un breve periodo dopo un'importazione manuale prima di verificare.

Scheda Importazione e limiti

1. Apri ADP Car Market Hub → Import & Limits.
2. La riga Ultima esecuzione mostra il timestamp dell'importazione completata più di recente.
3. La riga Stato dell'ultima esecuzione mostra i contatori dell'esecuzione più recente: inseriti, aggiornati, saltati, errori.
4. La riga Pianificazione mostra la configurazione corrente di WP-Cron o del cron del server.
5. Usa il pulsante Avvia importazione ora per eseguire un'importazione immediata e osservare il risultato.

Scheda Logs

1. Apri ADP Car Market Hub → Logs.
2. I pannelli Errori recenti e Avvisi recenti mostrano le ultime 50 voci di errore o avviso dal log, analizzando le ultime 2.000 righe.
3. Con la registrazione dettagliata abilitata, il visualizzatore di log mostra una riga per ogni veicolo elaborato: `` [INFO] Import vehicle {listing_id} (seller {seller_id}) begin. [INFO] Import vehicle {listing_id} result=updated. ``
4. Un'esecuzione di importazione completata produce una riga di riepilogo: `` [INFO] Import runner (wp-cron) finished: inserted=X updated=X skipped=X errors=X ``

Scheda Sistema e aiuto — Attività in background

1. Apri ADP Car Market Hub → System & Help.
2. La tabella Attività in background mostra l'hook del processo di importazione (as24ci_scheduled_import), la sua pianificazione, l'ora della prossima esecuzione e lo stato corrente del blocco.
3. I badge di stato indicano: - Pianificato (verde) — l'evento di importazione è in coda in WP-Cron - In esecuzione (giallo) — il blocco di importazione è attualmente attivo - Blocco bloccato (rosso) — è stato rilevato un blocco obsoleto; verrà rimosso automaticamente al prossimo tentativo di esecuzione - Non pianificato (giallo) — l'evento cron di importazione non è registrato; controlla le impostazioni di automazione - Gestito dal cron del server (verde) — la modalità cron del server è attiva

Comprendere il blocco di importazione

Il plugin utilizza un blocco temporaneo (as24ci_cron_import_running) per impedire esecuzioni di importazione sovrapposte. Il blocco memorizza il timestamp Unix di quando è iniziata l'esecuzione e scade dopo 40 minuti.

Se un'esecuzione di importazione si avvia mentre il blocco è attivo e non è obsoleto, la nuova esecuzione viene saltata e nel log viene scritto il seguente messaggio:

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

Se il blocco è più vecchio di 40 minuti (indicando che l'esecuzione precedente si è interrotta senza rilasciarlo), il blocco viene rimosso automaticamente e si procede con una nuova esecuzione:

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

Non è necessario rimuovere questo blocco manualmente durante il normale funzionamento.

Numero massimo di veicoli per esecuzione

Quando l'impostazione Numero massimo di veicoli per esecuzione è configurata su un valore diverso da zero, il processo di importazione si interrompe dopo aver elaborato quel numero di veicoli inseriti o aggiornati. I veicoli saltati (quelli senza modifiche) non contano ai fini di questo limite. Al raggiungimento del limite, il log registra:

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

La successiva esecuzione pianificata continuerà con gli annunci rimanenti. Questa impostazione è destinata ad ambienti con rigidi vincoli di tempo di esecuzione.

Monitoraggio del Full Sync

Quando Full Sync è abilitato, il processo di importazione esegue un passaggio aggiuntivo dopo l'importazione regolare: confronta tutti gli ID degli articoli dei veicoli importati localmente con l'insieme di ID degli annunci attivi restituiti dall'API ed elimina definitivamente tutti gli articoli locali i cui ID annuncio non sono più presenti.

Il risultato del Full Sync viene registrato nel log:

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

Attenzione: Il Full Sync non verrà eseguito se il limite di veicoli è stato raggiunto durante l'importazione, poiché l'insieme degli annunci remoti potrebbe essere incompleto. Questa è una misura di sicurezza per prevenire l'eliminazione di massa accidentale quando l'API restituisce un risultato parziale.

Il Full Sync viene saltato (con un avviso nel log) se l'insieme degli annunci remoti è vuoto.

Monitoraggio della connettività API

1. Apri ADP Car Market Hub → System & Help.
2. La scheda Connettività e API mostra: - Se l'URL di base dell'API è configurato e raggiungibile (codice di risposta HTTP e latenza) - Se un token OAuth valido è memorizzato nella cache e la sua data di scadenza - Se l'endpoint REST cron è raggiungibile (se è stato configurato un token cron) - Se l'API di Market Hub è raggiungibile

Se l'API non è raggiungibile durante un'importazione, gli errori vengono registrati per ciascun annuncio e conteggiati nel contatore errors.

Riferimento di configurazione

Note operative

• Il processo di importazione scrive il timestamp dell'ultima esecuzione in as24ci_last_run_time e i contatori di stato in as24ci_last_run_status nella tabella delle opzioni WordPress dopo ogni esecuzione.
• La scheda Dashboard legge da una cache temporanea con un TTL di 3 minuti. Immediatamente dopo un'importazione manuale, i conteggi visualizzati potrebbero non riflettere ancora l'ultima esecuzione.
• Il contatore api_active riflette il numero di annunci che hanno superato il filtro lato client del plugin (stato = activated, live = true). Questo numero potrebbe essere inferiore al totale grezzo riportato dall'API perché il plugin esclude gli annunci inattivi e non live prima dell'importazione.
• Il plugin tenta di aumentare il limite del tempo di esecuzione di PHP a 300 secondi all'inizio di ogni importazione attivata da WP-Cron o REST. Se il tuo ambiente di hosting non lo consente, le importazioni di cataloghi di grandi dimensioni potrebbero andare in timeout. La scheda System & Help mostra un badge per il valore corrente di max_execution_time.
• Sulle installazioni multisito di WordPress, ogni sito della rete ha la propria configurazione del Seller ID e la propria cronologia di importazione.

Risoluzione dei problemi

Documenti correlati

• Registrazione e monitoraggio
• Manutenzione della coda delle immagini
• Operazioni quotidiane
• Manutenzione settimanale