Documentation Commerce Guide Data Export pour les services SaaS

Consulter les journaux et résoudre les problèmes

Dernière mise à jour : 5 mai 2025

Rubriques :

Créé pour :

Administration

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.

nom du journal	nom de fichier	description
Log d'export de données SaaS	`commerce-data-export.log`	Fournit des informations sur les activités d’exportation de données, telles que les événements d’entité et les déclencheurs de resynchronisation complète. Chaque enregistrement de journal possède une structure spécifique et fournit des informations sur le flux, l’opération, le statut, le temps écoulé, l’ID de processus et l’appelant.
Journal des erreurs d'export des données SaaS	`data-export-errors.log`	Fournit des messages d’erreur et des traces de pile pour les erreurs qui se produisent pendant le processus de synchronisation des données.
Log d'export SaaS	`saas-export.log`	Fournit des informations sur les données envoyées aux services SaaS de Commerce.
Journal des erreurs d'export SaaS	`saas-export-errors.log`	Fournit des informations sur les erreurs qui se produisent lors de l’envoi de données aux services SaaS Commerce.

Si 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`>"
} [] []

REMARQUE

La chaîne basée sur JSON est enrichie pour une meilleure lisibilité.

Le tableau suivant décrit les types d’opérations qui peuvent être enregistrés dans les journaux.

Fonctionnement	Description	Exemple d’appelant
synchronisation complète	Collecte et envoie toutes les données au SaaS pour un flux donné.	`bin/magento saas:resync --feed=products`
réindexation partielle	Collecte et envoie des données au SaaS pour les entités mises à jour uniquement dans un flux donné. Ce journal est présent uniquement s’il existe des entités mises à jour.	`bin/magento cron:run --group=index`
réessayer les éléments ayant échoué	Renvoyez les éléments d’un flux donné à SaaS si l’opération de synchronisation précédente a échoué en raison d’une erreur de serveur ou d’application Commerce. Ce journal n’est présent que si des éléments ayant échoué existent.	`bin/magento cron:run --group=saas_data_exporter` (tout groupe cron « *_data_exportateur »)
synchronisation complète (héritée)	Collecte et envoie toutes les données au SaaS pour un flux donné en mode d’exportation hérité.	`bin/magento saas:resync --feed=categories`
réindexation partielle (héritée)	Envoie les entités mises à jour au SaaS pour un flux donné en mode d’exportation hérité. Ce journal est présent uniquement s’il existe des entités mises à jour.	`bin/magento cron:run --group=index`
synchronisation partielle (héritée)	Envoie les entités mises à jour au SaaS pour un flux donné en mode d’exportation hérité. Ce journal est présent uniquement s’il existe des entités mises à jour.	`bin/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 ».

Exemple : journal de resynchronisation complet pour le flux de prix

Price feed full resync:

[2024-03-05T21:00:51.754687+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Initialize","elapsed":"383 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:51.803178+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Creating batch table `catalog_data_exporter_product_prices_index_batches`. Start position: 30515","elapsed":"434 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:51.851878+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Batch table `catalog_data_exporter_product_prices_index_batches` created. Total Items: 500, batches: ~1","elapsed":"482 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:51.852548+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"start processing `500` items in `1` threads with `500` batch size","elapsed":"483 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:52.288369+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Progress 1\/1, processed 500, synced 0","elapsed":"919 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:53.994249+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Progress 1\/1, processed 500, synced 100","elapsed":"00:00:02 625 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []
[2024-03-05T21:00:53.995168+00:00] report.INFO: {"feed":"prices","operation":"full sync","status":"Complete","elapsed":"00:00:02 626 ms","pid":"14469","caller":"bin\/magento saas:resync --feed=prices"} [] []

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

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>

recommendation-more-help