Documentatie Commerce Data Export Guide for SaaS Services

Logboeken controleren en problemen oplossen

Laatst bijgewerkt: 5 mei 2025

Onderwerpen:

Gemaakt voor:

Beheerder

De extensie data export biedt logbestanden voor het bijhouden van gegevensvergaring- en synchronisatieprocessen.

Logboeken

Logbestanden zijn beschikbaar in de map var/log op de Commerce-toepassingsserver.

lognaam	filename	beschrijving
Logbestand SaaS-gegevensexport	`commerce-data-export.log`	Verstrekt informatie over de activiteiten van de gegevensuitvoer, zoals entiteitgebeurtenissen en volledige resync trekkers. Elk logboekverslag heeft een specifieke structuur en verstrekt informatie over het voer, de verrichting, de status, de verstreken tijd, proces identiteitskaart, en de bezoeker.
Logbestand met fouten bij exporteren SaaS-gegevens	`data-export-errors.log`	Verstrekt foutenmeldingen en stacksporen voor fouten die tijdens het proces van de gegevenssynchronisatie voorkomen.
SaaS-exportlogboek	`saas-export.log`	Verstrekt informatie over de gegevens die naar de diensten van Commerce SaaS worden verzonden.
Logbestand van SaaS-exportfout	`saas-export-errors.log`	Verstrekt informatie over fouten die voorkomen wanneer het verzenden van gegevens naar de diensten van Commerce SaaS.

Als u de verwachte gegevens voor een dienst van Adobe Commerce niet ziet, gebruik de foutenlogboeken voor de uitbreiding van de gegevensuitvoer om te bepalen waar het probleem voorkwam. Ook, kunt u logboeken met extra gegevens voor het volgen en het oplossen van problemen uitbreiden. Zie Uitgebreid registreren.

Logbestandsindeling

Elke logrecord heeft de volgende structuur.

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

OPMERKING

De op JSON gebaseerde tekenreeks is verfraaid voor betere leesbaarheid.

De volgende lijst beschrijft de verrichtingstypes die in de logboeken kunnen worden geregistreerd.

Bewerking	Beschrijving	Voorbeeld van de bezoeker
volledige synchronisatie	Verzamelt en verzendt alle gegevens naar SaaS voor een bepaalde voer.	`bin/magento saas:resync --feed=products`
gedeeltelijke reïndex	Verzamelt en verzendt gegevens naar SaaS voor slechts bijgewerkte entiteiten in een bepaalde feed. Dit logboek is alleen aanwezig als er bijgewerkte entiteiten zijn.	`bin/magento cron:run --group=index`
mislukte items opnieuw proberen	Verzend items voor een bepaalde feed opnieuw naar SaaS als de vorige synchronisatiebewerking is mislukt als gevolg van een Commerce-toepassing of serverfout. Dit logbestand is alleen aanwezig als mislukte items bestaan.	`bin/magento cron:run --group=saas_data_exporter` (elke "*_data_exporter"-structuurgroep)
volledige synchronisatie (verouderd)	Verzamelt en verzendt alle gegevens naar SaaS voor een bepaalde voer in erfenisuitvoerwijze.	`bin/magento saas:resync --feed=categories`
gedeeltelijke redex (verouderd)	Verzendt bijgewerkte entiteiten naar SaaS voor een bepaalde feed in de oudere exportmodus. Dit logboek is alleen aanwezig als er bijgewerkte entiteiten zijn.	`bin/magento cron:run --group=index`
gedeeltelijke synchronisatie (verouderd)	Verzendt bijgewerkte entiteiten naar SaaS voor een bepaalde feed in de oudere exportmodus. Dit logboek is alleen aanwezig als er bijgewerkte entiteiten zijn.	`bin/magento cron:run --group=saas_data_exporter` (elke "*_data_exporter"-structuurgroep)

Voorbeelden van logboekregistratie

Tijdens een volledige resync, wordt de vooruitgang gevolgd en geregistreerd elke 30 seconden door gebrek. Hier volgt een voorbeeld van een logbestandvermelding.

{
   "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"
}

In dit voorbeeld bieden de status -waarden informatie over de synchronisatiebewerking:

"Progress 2/5" geeft aan dat 2 van 5 herhalingen zijn voltooid. Het aantal herhalingen is afhankelijk van het aantal geëxporteerde entiteiten.
"processed: 200" geeft aan dat 200 items zijn verwerkt.
"synced: 100" geeft aan dat 100 items naar SaaS zijn verzonden. "synced" is niet gelijk aan "processed" . Hier volgt een voorbeeld:
- "synced" < "processed" betekent dat de voederlijst geen veranderingen in het punt, in vergelijking met de eerder gesynchroniseerde versie ontdekte. Dergelijke items worden genegeerd tijdens de synchronisatiebewerking.
- "synced" > "processed" dezelfde entiteit-id (bijvoorbeeld Product ID ) kan meerdere waarden in verschillende bereiken hebben. Eén product kan bijvoorbeeld worden toegewezen aan vijf websites. In dit geval kun je 1 verwerkt object en 5 gesynchroniseerde objecten hebben.

Voorbeeld: Volledig resync logboek voor het prijsvoer

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

Logbestanden met New Relic weergeven en problemen oplossen

Als u Adobe Commerce-logbestanden opslaat in de New Relic, kunt u parseringsregels toevoegen om de leesbaarheid en zoekervaring te verbeteren.

Meld u aan bij New Relic.
Ga naar Logs => Parsing .
Klik op Create parsing rule.
Vorm de het ontleden regel door de volgende waarden toe te voegen.
- Logboeken van de Filter die op NRQL worden gebaseerd
  
  filePath LIKE '%commerce-data-export%.log'
- het Ontwerpen regel
  
  \[%{DATA:timestamp}\] report.%{DATA:logLevel} %{GREEDYDATA:feed:json}

In dit voorbeeld wordt een regel toegevoegd waarmee u New Relic-logbestanden kunt opvragen op basis van een bepaald type feed, bewerking, enzovoort.

koord van de de vraagvraag van het Voorbeeld - feed.feed:"products" and feed.status:"Complete"

Problemen oplossen

Als er gegevens ontbreken of onjuist zijn in Commerce Services, controleert u in de logboeken op berichten over fouten die zijn opgetreden tijdens het synchroniseren van Adobe Commerce naar het Commerce Services-platform. Indien nodig, gebruik uitgebreide registreren om extra informatie aan logboeken voor het oplossen van problemen toe te voegen.

Het foutenlogboek van de Uitvoer van Gegevens (commerce-data-export-errors.log) vangt fouten die tijdens de inzamelingsfase voorkomen.
Het saaS foutenlogboek van de Uitvoer (saas-export-errors.log) vangt fouten die tijdens de transmissiefase voorkomen.

Als u fouten niet verwant met configuratie of derdeuitbreidingen ziet, leg a steunkaartjemet zoveel mogelijk informatie voor.

Synchronisatieproblemen met catalogi oplossen

Wanneer u een gegevensresync teweegbrengt, kan het tot een uur voor de gegevens duren om bij te werken en in UI componenten zoals levende onderzoek en aanbeveling eenheden worden weerspiegeld. Raadpleeg het volgende als u nog steeds discrepanties ziet tussen uw catalogus en de gegevens in de Commerce-winkel of als de catalogussynchronisatie is mislukt:

Gegevensafwijking

Geef de gedetailleerde weergave van het desbetreffende product weer in de zoekresultaten.
Kopieer de JSON-uitvoer en controleer of de inhoud overeenkomt met de inhoud in de catalogus van Commerce .
Als de inhoud niet overeenkomt, brengt u een kleine wijziging aan in het product in de catalogus, zoals het toevoegen van een spatie of een punt.
Wacht op een resync of teweegbrengen een hand opnieuw.

Synchronisatie wordt niet uitgevoerd

Als de synchronisatie niet op een programma loopt of niets wordt gesynchroniseerd, zie dit 🔗 artikel 0} KnowledgeBase {.

Synchronisatie is mislukt

Als de catalogussynchronisatie een status van Ontbroken heeft, leg a steunkaartjevoor.

Uitgebreide logboekregistratie

Gebruik omgevingsvariabelen om logbestanden uit te breiden met extra gegevens voor bijhouden en problemen oplossen. Voeg de omgevingsvariabele aan de opdrachtregel toe wanneer u de opdrachten voor het exporteren van gegevens uitvoert, zoals in de volgende voorbeelden wordt getoond.

Controleer de lading van de voer

Neem de payload van de feed op in het SaaS-exportlogboek door de omgevingsvariabele EXPORTER_EXTENDED_LOG=1 toe te voegen wanneer u de feed opnieuw synchroniseert.

EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed=products

Nadat de verrichting voltooit, is de voederlading beschikbaar voor overzicht in het de uitvoerlogboek van SaaS (var/.log/saas-export.log).

Payload behouden in voederindextabel

Voor de Commerce SaaS-extensie voor gegevensuitvoer (magento/module-data-exporter) 103.3.0 en hoger, behouden directe exportfeeds alleen de minimaal vereiste gegevens in de indextabel. De feeds bevatten alle statusfeeds voor catalogi en voorraden.

Het behouden van ladingsgegevens in de indexlijst wordt niet geadviseerd in productiemilieu's, maar het kan in een ontwikkelaarmilieu nuttig zijn. Neem de payload van de feed op in de index door de omgevingsvariabele PERSIST_EXPORTED_FEED=1 toe te voegen wanneer u de feed opnieuw synchroniseert.

PERSIST_EXPORTED_FEED=1 bin/magento saas:resync --feed=products

Profiel uitvoeren om trage prestaties op te lossen

Als het opnieuw indexproces van een specifieke voer een onredelijke hoeveelheid tijd vergt, stel profiler in werking om extra gegevens te verzamelen die voor het Team van de Steun nuttig zouden kunnen zijn.

Voer de analyse uit door de omgevingsvariabele EXPORTER_PROFILER=1 toe te voegen wanneer u de opdracht Opnieuw indexeren uitvoert.

EXPORTER_PROFILER=1 bin/magento indexer:reindex catalog_data_exporter_products

Profilergegevens worden opgeslagen in het logboek voor gegevensexport (var/log/commerce-data-export.log) in de volgende indeling:

<Provider class name>, <# of processed entities>, <execution time im ms>, <memory consumption in Mb>

recommendation-more-help