Monitoraggio dello stato di sincronizzazione dei feed di dati
Gli amministratori di Adobe Commerce possono monitorare lo stato di sincronizzazione dei dati esportati da Adobe Commerce ai servizi Commerce connessi utilizzando la pagina Stato sincronizzazione feed dati in Amministratore Commerce.
Questa pagina fornisce informazioni in tempo reale sullo stato e sulle prestazioni dei feed di esportazione dei dati che trasferiscono i dati di prodotti e categorie da Commerce a servizi esterni quali Product Recommendations, Live Search e Catalog Service.
La pagina Stato di sincronizzazione mostra solo lo stato di esportazione. Uno stato di operazione riuscita indica che i dati sono stati esportati correttamente e saranno infine disponibili nei servizi Commerce connessi. Utilizza il dashboard di gestione dati per visualizzare lo stato effettivo della sincronizzazione delle entità.
Il monitoraggio dello stato dei feed consente di garantire la coerenza dei dati e di risolvere rapidamente eventuali problemi che si verificano durante il processo di esportazione. Gli amministratori possono:
- Visualizza lo stato di sincronizzazione per tutti i feed di dati
- Identificare e risolvere gli errori nell'elaborazione dei feed
- Accedi a informazioni dettagliate sullo stato per singoli elementi del feed
Lo stato viene tracciato per i seguenti feed:
- Feed prodotti
- Feed attributi prodotto
- Feed categorie
- Feed sostituzioni prodotto
- Feed prezzi prodotto
- Feed varianti prodotto
Installare l’estensione
La pagina Stato feed dati è disponibile per tutti i commercianti Commerce con licenze attive per i seguenti servizi Commerce:
- Product Recommendations v6.0.0+
- Live Search v4.1.0+
- Catalog Service v1.17+ con una licenza attiva.
Requisiti
-
PHP 8.1, 8.2, 8.3 o 8.4
-
Adobe Commerce 2.4.4+
-
Estensione Adobe Commerce Data Export, versione 103.4.15 o successiva
-
Accedi a repo.magento.com
Per generare le chiavi e ottenere i diritti necessari, vedere Ottenere le chiavi di autenticazione. Per le installazioni cloud, consulta la Guida di Commerce sull'infrastruttura cloud.
-
Accedere alla riga di comando del server applicazioni Adobe Commerce.
Passaggi per l’installazione
Aggiungi il modulo magento/module-data-exporter-status tramite Compositore:
composer require magento/module-data-exporter-status
Per i passaggi dettagliati dell’installazione, consulta le seguenti guide:
Accedere alla pagina Stato feed dati
Dall'amministratore di Commerce, accedere alla pagina Stato feed dati dall'amministratore di Commerce in System > Trasferimento dati > Data Feed Sync Status.
Il monitoraggio dello stato dei feed dati fornisce due interfacce:
- Pagina di riepilogo dello stato di sincronizzazione dei feed dati in cui sono elencati i feed disponibili e lo stato corrente
- Stato sincronizzazione feed dati - Pagina dettagli che mostra informazioni dettagliate su un feed selezionato.
Riepilogo stato sincronizzazione feed dati
La pagina di riepilogo dello stato di sincronizzazione dei feed fornisce informazioni sull’attività di esportazione dei feed di dati, tra cui le seguenti:
Dettagli sullo stato di sincronizzazione del feed dati
Dalla pagina di riepilogo dello stato dei feed dati, fare clic su un nome di feed o utilizzare l'azione View Details per accedere a informazioni dettagliate sui singoli record all'interno di un feed.
La vista Dettaglio fornisce le seguenti informazioni per ciascun elemento del feed:
Potete gestire la vista utilizzando i seguenti controlli:
- Mass Action per pianificare la risincronizzazione per gli elementi feed selezionati
- Filters
- Default View per creare e salvare una visualizzazione filtrata e passare da una visualizzazione all'altra
- Columns per mostrare e nascondere le colonne nella tabella.
Indicatori di salute dei mangimi
Nella parte superiore di ogni pagina dei dettagli dei feed, gli indicatori di integrità critici forniscono lo stato del sistema per ciascun feed:
Stato indicizzatore
- Valido: dati sincronizzati. Non è richiesta alcuna reindicizzazione.
- Non valido: i dati originali sono stati modificati. L'indice deve essere aggiornato.
- Elaborazione: indicizzazione in corso.
Backlog di Changelog
- Tutti sincronizzati: nessuna modifica in sospeso da elaborare
- Elementi nel backlog: numero di modifiche in sospeso in attesa di elaborazione
Esporta tipi di stato
Il sistema fornisce indicatori di stato che consentono di identificare rapidamente i problemi:
Categorie di stato
Monitorare lo stato del feed dati
Quando si aggiornano entità relative a prodotti e categorie nel database di Commerce, i dati vengono trasferiti ai servizi di Commerce in base alla configurazione del feed. Puoi monitorare questo processo in tempo reale dalla pagina di riepilogo dello stato di sincronizzazione dei feed di dati.
Quando il numero di record inviati correttamente corrisponde al numero di record di origine, indica che la sincronizzazione è stata completata e che tutti i dati sono stati trasmessi correttamente.
Gestione delle esportazioni non riuscite
Per visualizzare i dettagli delle esportazioni non riuscite e intraprendere azioni correttive:
-
Nella pagina Stato sincronizzazione feed, individua il feed con record non riusciti.
-
Fare clic su Details.
-
Esaminare i messaggi di errore per motivi specifici.
-
Utilizzare le azioni di massa per pianificare le operazioni di risincronizzazione per gli elementi non riusciti.
Risincronizzazione dei dati non riuscita
È possibile risincronizzare manualmente i feed di dati con errori o problemi utilizzando il menu Actions nella pagina Data Feed Sync Status - Details.
Mentre il sistema esegue automaticamente nuovi tipi di guasti, può essere necessario un intervento manuale nei seguenti scenari:
- Si verificano errori di autenticazione o autorizzazione (codici di stato 401, 403).
- Dopo aver risolto i problemi di formato dei dati che causavano errori di payload.
- I seguenti aggiornamenti alle configurazioni di servizio o agli endpoint esterni.
- Stai distribuendo personalizzazioni che influiscono sui processi di esportazione dei dati.
Monitorando in modo proattivo lo stato dei feed e risolvendo tempestivamente gli errori, puoi mantenere la coerenza e l’affidabilità dei dati nell’ecosistema Commerce.
Risincronizza manualmente elementi feed
Se è necessario risincronizzare elementi di feed specifici:
- Seleziona record: utilizzare le caselle di controllo per selezionare i record non riusciti che richiedono attenzione.
- Scegli azione: seleziona Schedule Resync dal menu a discesa Azione di massa.
- Conferma: fare clic su Submit e confermare l'operazione di risincronizzazione.
- Monitora risultati: controlla il messaggio di operazione riuscita e monitora le modifiche di stato.
Best practice
Monitoraggio regolare
- Controlli giornalieri: controlla la pagina della panoramica ogni giorno per eventuali feed che mostrano tassi di errore elevati
- Approfondimento settimanale: esamina lo stato dettagliato dei feed critici (prodotti, prezzi)
- Analisi mensile: tieni traccia delle tendenze nelle percentuali di successo e nelle prestazioni delle esportazioni
Risoluzione dei problemi del flusso di lavoro
- Identifica problemi: cerca errori e conteggi di errori elevati
- Verifica stato indicizzatore: verificare che gli indicizzatori siano validi e che il backlog sia gestibile
- Rivedi dettagli errore: fai clic sui record con errori per visualizzare messaggi di errore specifici
- Pianifica risincronizzazione: utilizza azioni di massa per ritentare le esportazioni non riuscite
- Risoluzione monitor: verificare che gli elementi risincronizzati mostrino uno stato corretto
Correggi i problemi comuni
Elevate percentuali di errori
Sintomi: un numero elevato di record indica lo stato "Non riuscito, richiede attenzione"
Possibili cause:
- Modifiche alla configurazione del servizio esterno
- Incompatibilità del formato dei dati
- Problemi di autenticazione o autorizzazione
Passaggi di risoluzione:
- Verifica lo stato e la configurazione del servizio esterno
- Revisione dei messaggi di errore per i modelli
- Verifica credenziali di autenticazione
- Se necessario, contatta il supporto di servizi esterni
Prestazioni di esportazione lente
Sintomi: backlog del registro modifiche elevato, aggiornamenti dello stato lenti
Possibili cause:
- Problemi di prestazioni dell’indicizzatore
- Volume di dati elevato
- Limitazione della frequenza dei servizi esterni
Passaggi risoluzione:
- Controlla lo stato dell’indicizzatore ed esegui di nuovo se non valido
- Monitorare i tempi di risposta del servizio esterno
- Pianificazione delle esportazioni durante le ore di minore utilizzo
- Esaminare le risorse e le prestazioni del sistema
Errori di autenticazione
Sintomi: codici di stato 401 o 403
Passaggi risoluzione:
- Verifica credenziali API e token
- Verifica le autorizzazioni dell’account del servizio esterno
- Rinnovare token di autenticazione scaduti
- Contattare il provider di servizi per problemi di accesso