Consulter les journaux et résoudre les problèmes
L’extension data export fournit des journaux pour suivre les processus de collecte de données et de synchronisation.
Logs
Les journaux sont disponibles dans le répertoire var/log du serveur d’applications Commerce.
commerce-data-export.logdata-export-errors.logsaas-export.logsaas-export-errors.logSi vous ne voyez pas les données attendues pour un service Adobe Commerce, utilisez les journaux d’erreurs de l’extension d’exportation des données pour déterminer où le problème s’est produit. Vous pouvez également étendre les journaux avec des données supplémentaires pour le suivi et le dépannage. Voir Journalisation étendue.
Format du log
Chaque enregistrement de journal présente la structure suivante.
[<log record datetime>] report.<log level>:
{
"feed": "<feed name>",
"operation": "<executed operation>",
"status": "<status of operation>",
"elapsed": "<time elapsed from script run>",
"pid": "<process id that executed `operation`>",
"caller": "<who called this `operation`>"
} [] []
Le tableau suivant décrit les types d’opérations qui peuvent être enregistrés dans les journaux.
bin/magento saas:resync --feed=productsbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (tout groupe cron « *_data_exportateur »)bin/magento saas:resync --feed=categoriesbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (tout groupe cron « *_data_exportateur »)Exemples de journalisation
Lors d’une resynchronisation complète, la progression est suivie et consignée toutes les 30 secondes par défaut. Voici un exemple d’entrée de journal.
{
"feed": "prices",
"operation": "full sync",
"status": "Progress: 2/5, processed: 200, synced: 100",
"elapsed": "00:00:00 190 ms",
"pid": "12824",
"caller": "bin/magento saas:resync --feed=products"
}
Dans cet exemple, les valeurs status fournissent des informations sur l’opération de synchronisation :
-
"Progress 2/5"indique que 2 itérations sur 5 ont été terminées. Le nombre d’itérations dépend du nombre d’entités exportées. -
"processed: 200"indique que 200 éléments ont été traités. -
"synced: 100"indique que 100 articles ont été envoyés à SaaS. On s’attend à ce que"synced"ne soit pas égal à"processed". Voici un exemple :"synced" < "processed"signifie que la table de flux n’a détecté aucune modification dans l’élément, par rapport à la version synchronisée précédemment. Ces éléments sont ignorés pendant l’opération de synchronisation."synced" > "processed"même id d’entité (par exemple,Product ID) peut avoir plusieurs valeurs dans différentes portées. Par exemple, un produit peut être attribué à cinq sites web. Dans ce cas, il se peut que vous ayez « 1 élément traité » et « 5 éléments synchronisés ».
| code language-none |
|---|
|
Affichage et résolution des problèmes liés aux journaux avec New Relic
Si vous stockez les journaux Adobe Commerce dans le New Relic, vous pouvez ajouter des règles d’analyse pour améliorer la lisibilité et l’expérience des requêtes.
-
Connectez-vous à New Relic.
-
Accédez à
Logs => Parsing. -
Cliquez sur
Create parsing rule. -
Configurez la règle d’analyse en ajoutant les valeurs suivantes.
-
Filtrer les journaux en fonction de NRQL
filePath LIKE '%commerce-data-export%.log' -
Règle d'analyse
\[%{DATA:timestamp}\] report.%{DATA:logLevel} %{GREEDYDATA:feed:json}
-
Cet exemple ajoute une règle qui vous permet d’interroger les journaux New Relic par type de flux spécifique, opération, etc.
Exemple de chaîne de requête—feed.feed:"products" and feed.status:"Complete"
Dépannage
Si des données sont manquantes ou incorrectes dans les services Commerce, recherchez dans les journaux les messages d’erreur relatifs à la synchronisation entre Adobe Commerce et la plateforme des services Commerce. Si nécessaire, utilisez la journalisation étendue pour ajouter des informations supplémentaires aux journaux à des fins de dépannage.
- Le journal des erreurs d’exportation des données (
commerce-data-export-errors.log) capture les erreurs qui se produisent pendant la phase de collecte. - Le journal des erreurs d’exportation SaaS (
saas-export-errors.log) capture les erreurs qui se produisent pendant la phase de transmission.
Si vous rencontrez des erreurs non liées à la configuration ou aux extensions tierces, envoyez un ticket d’assistance avec autant d’informations que possible.
Résolution des problèmes de synchronisation des catalogues resolvesync
Lorsque vous déclenchez une resynchronisation des données, la mise à jour des données peut prendre jusqu’à une heure et ces données peuvent être reflétées dans les composants de l’interface utilisateur tels que la recherche en direct et les unités de recommandation. Si des incohérences persistent entre votre catalogue et les données du storefront Commerce, ou si la synchronisation du catalogue a échoué, reportez-vous aux sections suivantes :
Incohérence des données
- Afficher la vue détaillée du produit en question dans les résultats de la recherche.
- Copiez la sortie JSON et vérifiez que le contenu correspond à ce que vous avez dans le catalogue Commerce.
- Si le contenu ne correspond pas, apportez une modification mineure au produit de votre catalogue, par exemple en ajoutant un espace ou un point.
- Attendez une resynchronisation ou déclenchez une resynchronisation manuelle.
Synchronisation non exécutée
Si la synchronisation ne s’exécute pas selon un planning ou si rien n’est synchronisé, consultez cet article Base de connaissances.
Échec de la synchronisation
Si la synchronisation du catalogue a le statut Échec, envoyez un ticket d’assistance 🔗.
Journalisation étendue
Utilisez des variables d’environnement pour étendre les journaux avec des données supplémentaires à des fins de suivi et de dépannage. Ajoutez la variable d’environnement à la ligne de commande lorsque vous exécutez les commandes de l’interface de ligne de commande d’exportation des données, comme illustré dans les exemples suivants.
Vérifier la payload du flux
Incluez la payload du flux dans le journal d’exportation SaaS en ajoutant la variable d’environnement EXPORTER_EXTENDED_LOG=1 lorsque vous resynchronisez le flux.
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed=products
Une fois l’opération terminée, la payload de flux peut être consultée dans le journal d’exportation SaaS (var/.log/saas-export.log).
Conserver la payload dans la table d’index de flux
Pour l’extension d’exportation de données SaaS Commerce (magento/module-data-exporter) 103.3.0 et versions ultérieures, les flux d’exportation immédiats conservent uniquement les données minimales requises dans la table d’index. Les flux comprennent tous les flux de statut du stock de catalogue et d’inventaire.
La conservation des données de payload dans la table d’index n’est pas recommandée dans les environnements de production, mais elle peut s’avérer utile dans un environnement de développement. Incluez la payload du flux dans l’index en ajoutant la variable d’environnement PERSIST_EXPORTED_FEED=1 lorsque vous resynchronisez le flux.
PERSIST_EXPORTED_FEED=1 bin/magento saas:resync --feed=products
Exécutez le profileur pour résoudre les problèmes de performances lentes.
Si le processus de réindexation d’un flux spécifique prend un temps déraisonnable, exécutez le profileur pour collecter des données supplémentaires qui peuvent être utiles à l’équipe d’assistance.
Exécutez le profileur en ajoutant la variable d’environnement EXPORTER_PROFILER=1 lorsque vous exécutez la commande de réindexation.
EXPORTER_PROFILER=1 bin/magento indexer:reindex catalog_data_exporter_products
Les données du profileur sont stockées dans le journal d’exportation des données (var/log/commerce-data-export.log) au format suivant :
<Provider class name>, <# of processed entities>, <execution time im ms>, <memory consumption in Mb>