Surveillance Du Statut De Synchronisation Des Flux De Données
Les administrateurs Adobe Commerce peuvent surveiller le statut de synchronisation des données exportées d’Adobe Commerce vers les services Commerce connectés à l’aide de la page Statut de synchronisation des flux de données dans l’administration Commerce.
Cette page fournit des informations en temps réel sur l’intégrité et les performances des flux d’exportation de données qui transfèrent les données de produit et de catégorie de Commerce vers des services externes tels que Product Recommendations, Live Search et Catalog Service.
La page du statut de synchronisation affiche uniquement le statut d’exportation. Un statut de réussite indique que l’exportation des données a réussi et qu’elles seront éventuellement disponibles dans les services Commerce connectés. Utilisez le tableau de bord de la gestion des données pour afficher l’état réel de la synchronisation des entités.
La surveillance du statut des flux permet d’assurer la cohérence des données et de résoudre rapidement les problèmes qui surviennent pendant le processus d’exportation. Les administrateurs peuvent :
- Afficher l’état de synchronisation pour tous les flux de données
- Identifier et résoudre les erreurs lors du traitement des flux
- Accéder aux informations détaillées sur le statut pour les éléments de flux individuels
Le statut est suivi pour les flux suivants :
- Flux de produits
- Flux d’attributs de produit
- Flux de catégories
- Flux de remplacements de produit
- Flux des prix des produits
- Flux de variantes de produit
Installation de l’extension
La page Statut du flux de données est disponible pour tous les commerçants Commerce disposant de licences actives pour les services Commerce suivants :
- Product Recommendations v6.0.0+
- Live Search v4.1.0+
- Catalog Service v1.17+ avec une licence active.
Conditions requises
-
PHP 8.1, 8.2, 8.3 ou 8.4
-
Adobe Commerce 2.4.4+
-
Extension Adobe Commerce Data Export, version 103.4.15 ou ultérieure
-
Accès à repo.magento.com
Pour générer des clés et obtenir les droits nécessaires, voir Obtenir vos clés d’authentification . Pour les installations cloud, consultez le guide Commerce sur les infrastructures cloud.
-
Accès à la ligne de commande du serveur applicatif Adobe Commerce.
Etapes d'installation
Ajoutez le module magento/module-data-exporter-status à l’aide du compositeur :
composer require magento/module-data-exporter-status
Pour obtenir des instructions d’installation détaillées, consultez les guides suivants :
Accès à la page Statut du flux de données
À partir de l’Administration Commerce, accédez à la page Statut du flux de données à partir de l’Administration Commerce sous System > Transfert de données > Data Feed Sync Status.
La surveillance du statut des flux de données fournit deux interfaces :
- La page récapitulative du statut de synchronisation des flux de données qui répertorie les flux disponibles et l’état actuel
- La page Statut de synchronisation des flux de données - Détails qui affiche des informations détaillées sur un flux sélectionné.
Résumé du statut de synchronisation des flux de données
La page de synthèse du statut de synchronisation des flux fournit des informations sur l’activité d’exportation des flux de données, notamment les informations suivantes :
Détails du statut de synchronisation du flux de données
Dans la page de résumé du statut du flux de données , cliquez sur le nom d’un flux ou utilisez l’action View Details pour accéder à des informations détaillées sur les enregistrements individuels d’un flux.
La vue détaillée fournit les informations suivantes pour chaque élément de flux :
Vous pouvez gérer la vue à l'aide des commandes suivantes :
- Mass Action de planifier la resynchronisation des éléments de flux sélectionnés
- Filters
- Default View de créer et d’enregistrer une vue filtrée, et de basculer entre les vues
- Columns d’afficher et de masquer les colonnes du tableau.
Indicateurs d’intégrité des flux
En haut de la page des détails de chaque flux, les indicateurs d’intégrité critiques indiquent l’état du système pour chaque flux :
Statut de l’indexeur
- Valide : les données sont synchronisées ; aucune réindexation n’est requise.
- Non valide : les données d’origine ont été modifiées. L’index doit être mis à jour.
- Traitement : indexation en cours.
Liste d'attente du journal des modifications
- Tous synchronisés : aucune modification en attente à traiter
- Éléments dans la liste d'attente : nombre de modifications en attente de traitement
Types de statut d'export
Le système fournit des indicateurs de statut pour vous aider à identifier rapidement les problèmes :
Catégories de statut
Surveillance du statut des flux de données
Lorsque vous mettez à jour des entités liées à des produits et à des catégories dans la base de données Commerce, les données sont transférées vers les services Commerce en fonction de la configuration de votre flux. Vous pouvez surveiller ce processus en temps réel à partir de la page de résumé du statut de synchronisation des flux de données .
Lorsque le nombre d’enregistrements envoyés avec succès correspond au nombre d’enregistrements sources, cela indique que la synchronisation est terminée et que toutes les données ont été transmises avec succès.
Gestion des exportations ayant échoué
Pour afficher les détails des exportations ayant échoué et prendre des mesures correctives :
-
Sur la page État de synchronisation des flux , recherchez le flux avec des enregistrements ayant échoué.
-
Cliquez sur Details.
-
Consultez les messages d’erreur pour des raisons d’échec spécifiques.
-
Utilisez des actions en masse pour planifier des opérations de resynchronisation pour les éléments ayant échoué.
Données d’échec de resynchronisation
Vous pouvez resynchroniser manuellement les flux de données ayant échoué ou posé problème à l’aide du menu Actions de la page Data Feed Sync Status - Details.
Alors que le système tente automatiquement de reproduire certains types d’échecs, une intervention manuelle peut s’avérer nécessaire dans les scénarios suivants :
- Vous constatez des erreurs d’authentification ou d’autorisation (codes d’état 401 et 403).
- Après avoir résolu les problèmes de format de données qui provoquaient des erreurs de payload.
- Suivi des mises à jour des configurations de service externes ou des points d’entrée.
- Vous déployez des personnalisations qui affectent les processus d’exportation de données.
En surveillant de manière proactive l’état des flux et en corrigeant rapidement les défaillances, vous pouvez maintenir la cohérence et la fiabilité des données dans l’ensemble de votre écosystème Commerce.
Resynchroniser manuellement les éléments de flux
Si vous devez resynchroniser des éléments de flux spécifiques :
- Sélectionner les enregistrements : utilisez des cases à cocher pour sélectionner les enregistrements ayant échoué et nécessitant une attention particulière.
- Choisir une action : sélectionnez Schedule Resync dans la liste déroulante d’actions en masse.
- Confirmer : cliquez sur Submit et confirmez l’opération de resynchronisation.
- Surveiller les résultats : vérifiez le message de réussite et surveillez les modifications de statut.
Bonnes pratiques
Surveillance régulière
- Contrôles quotidiens : consultez quotidiennement la page d’aperçu des flux présentant des taux d’échec élevés
- Weekly Deep Dive : examiner le statut détaillé des flux critiques (produits, prix)
- Analyse mensuelle : suivez les tendances en matière de taux de réussite et de performances des exportations
Workflow de dépannage
- Identifier les problèmes : rechercher les erreurs et les nombres d’échecs élevés
- Vérifier l’intégrité de l’indexeur : assurez-vous que les indexeurs sont valides et que la liste d’attente est gérable
- Consulter les détails de l’erreur : cliquez sur les enregistrements ayant échoué pour afficher des messages d’erreur spécifiques
- Planifier la resynchronisation : utilisez des actions en masse pour réessayer les exportations ayant échoué.
- Résolution du moniteur : vérifiez que les éléments resynchronisés affichent le statut Succès
Correction de problèmes courants
Taux d’échec élevés
Symptômes : grand nombre d’enregistrements affichant le statut « Échec, nécessite une attention particulière »
Causes potentielles :
- Modifications de la configuration du service externe
- Incompatibilités entre les formats de données
- Problèmes d’authentification ou d’autorisation
Étapes de résolution :
- Vérifier le statut et la configuration du service externe
- Vérifier les messages d’erreur pour les modèles
- Vérifier les informations d’authentification
- Contactez le support technique externe si nécessaire
Performances d’exportation lentes
Symptômes : journal des modifications volumineux, mises à jour de statut lentes
Causes potentielles :
- Problèmes de performances de l’indexeur
- Volume de données élevé
- Limitation de débit de service externe
Étapes de résolution :
- Vérifier le statut de l’indexeur et le réexécuter s’il n’est pas valide
- Surveiller les temps de réponse du service externe
- Envisagez de planifier des exportations pendant les heures creuses
- Examen des ressources et des performances du système
Échecs d'authentification
Symptômes : codes d’état 401 ou 403
Étapes de résolution :
- Vérification des informations d’identification et des jetons d’API
- Vérifier les autorisations du compte de service externe
- Renouveler les jetons d’authentification expirés
- Contactez votre fournisseur pour les problèmes d’accès