檢閱記錄檔並進行疑難排解
data export擴充功能提供記錄檔以追蹤資料收集和同步處理程式。
記錄檔
記錄檔位於Commerce應用程式伺服器上的var/log目錄中。
commerce-data-export.logdata-export-errors.logsaas-export.logsaas-export-errors.log如果您沒有看到Adobe Commerce服務的預期資料，請使用資料匯出擴充功能的錯誤記錄檔，以判斷發生問題的位置。 此外，您也可以使用其他資料來擴充記錄檔，以進行追蹤和疑難排解。 請參閱延伸記錄。
記錄格式
每個記錄檔記錄都有以下結構。
[<log record datetime>] report.<log level>:
{
"feed": "<feed name>",
"operation": "<executed operation>",
"status": "<status of operation>",
"elapsed": "<time elaspsed from script run>",
"pid": "<proccess id who executed `operation`>",
"caller": "<who called this `operation`>"
} [] []
下表說明可記錄在記錄中的作業型別。
bin/magento saas:resync --feed=productsbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (任何「*_data_exporter」cron群組)bin/magento saas:resync --feed=categoriesbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (任何「*_data_exporter」cron群組)記錄範例
在完全重新同步期間，預設會每30秒追蹤並記錄一次進度。 紀錄專案範例如下。
{
"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"
}
在此範例中，status值提供同步作業的相關資訊：
-
"Progress 2/5"表示已完成5個反複專案中的2個。 版序的數目取決於匯出的圖元數目。 -
"processed: 200"表示已處理200個專案。 -
"synced: 100"表示已傳送100個專案至SaaS。 預期"synced"不等於"processed"。 範例如下："synced" < "processed"表示與先前同步版本相比，摘要資料表未偵測到專案中的任何變更。 同步作業期間會忽略此類專案。"synced" > "processed"相同的實體ID （例如，Product ID）可以在不同的範圍中有多個值。 例如，一個產品可指派至五個網站。 在此情況下，您可能會有「1個已處理」專案和「5個已同步」專案。
| code language-none |
|---|
|
使用New Relic檢視及疑難排解記錄
如果您將Adobe Commerce記錄檔儲存在New Relic中，可以新增剖析規則以改善可讀性和查詢體驗。
-
登入New Relic。
-
移至
Logs => Parsing。 -
按一下
Create parsing rule。 -
新增下列值以設定剖析規則。
-
根據NRQL 篩選記錄檔
filePath LIKE '%commerce-data-export%.log' -
剖析規則
\[%{DATA:timestamp}\] report.%{DATA:logLevel} %{GREEDYDATA:feed:json}
-
此範例新增規則，可讓您依特定摘要型別、操作等查詢New Relic記錄。
查詢字串範例—feed.feed:"products" and feed.status:"Complete"
疑難排解
如果Commerce Services中的資料遺失或不正確，請檢查記錄檔，以檢視從Adobe Commerce執行個體同步至Commerce Service平台期間是否發生問題。 如有需要，請使用擴充記錄功能，在記錄檔中新增其他資訊以進行疑難排解。
- commerce-data-export-errors.log — 如果在收集階段發生錯誤
- saas-export-errors.log — 如果在傳輸階段發生錯誤
如果您看到與設定或協力廠商擴充功能無關的錯誤，請儘可能提交支援票證並提供更多資訊。
解決目錄同步問題 resolvesync
觸發資料重新同步時，最多可能需要一小時的時間才會更新資料，並反映在UI元件（例如即時搜尋和建議單位）中。 如果您仍然看到目錄與Commerce店面上的資料不一致，或目錄同步失敗，請參閱以下內容：
資料差異
- 在搜尋結果中顯示相關產品的詳細檢視。
- 複製JSON輸出，並確認內容符合您在Commerce目錄中的內容。
- 如果內容不符，請對目錄中的產品進行微幅變更，例如新增空格或句點。
- 等候重新同步或觸發手動重新同步。
同步處理未執行
如果同步未依排程執行，或未同步任何專案，請參閱此知識庫文章。
同步失敗
如果目錄同步處理的狀態為 失敗，請提交支援票證。
延伸記錄
如需其他記錄資訊，您可以使用環境變數，透過其他資料擴充記錄檔以進行追蹤和疑難排解。
var/log/目錄中有兩個記錄檔：
- commerce-data-export-errors.log — 如果在收集階段發生錯誤
- saas-export-errors.log — 如果在傳輸階段發生錯誤
您可以使用環境變數，透過其他資料擴充記錄檔以進行追蹤和疑難排解。
檢查摘要裝載
當您重新同步摘要時，新增EXPORTER_EXTENDED_LOG=1環境變數，將摘要裝載包含在SaaS匯出記錄中。
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed=products
作業完成後，摘要承載可在SaaS匯出記錄檔(var/.log/saas-export.log)中檢視。
保留摘要索引表格中的裝載
對於Commerce SaaS資料匯出擴充功能(magento/module-data-exporter) 103.3.0和更新版本，立即匯出摘要只會保留索引表格中最低限度的必要資料。 摘要包含所有目錄和庫存狀態摘要。
不建議在生產環境中保留索引表中的裝載資料，但在開發人員環境中可能會很有用。 當您重新同步摘要時，新增PERSIST_EXPORTED_FEED=1環境變數，以在索引中包含摘要裝載。
PERSIST_EXPORTED_FEED=1 bin/magento saas:resync --feed=products
執行Profiler以疑難排解效能緩慢的問題
如果特定摘要的重新索引程式耗時過長，請執行效能評測器以收集可能對支援團隊有用的其他資料。
執行reindex命令時新增EXPORTER_PROFILER=1環境變數，以執行Profiler。
EXPORTER_PROFILER=1 bin/magento indexer:reindex catalog_data_exporter_products
效能分析工具資料會以下列格式儲存在資料匯出記錄檔(var/log/commerce-data-export.log)中：
<Provider class name>, <# of processed entities>, <execution time im ms>, <memory consumption in Mb>