Adobe Commerce的進階報告疑難排解員

Last update: Mon Feb 02 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

本文提供結構化的疑難排解決策樹，用於診斷及解決Adobe Commerce中的進階報告問題。它會引導您完成目標性的診斷問題，並根據您的回答將您導向相關的查詢、修補程式或檔案。工作流程有助於識別根本原因，例如設定差距、貨幣不相符、代號問題和cron相關失敗。

說明 description

環境

雲端基礎結構上的Adobe Commerce

問題/症狀

進階報告儀表板未顯示任何資料
存取進階報告時出現404錯誤
Adobe Commerce與進階報告之間的同步處理延遲
設定中遺失或無效的權杖
在設定或歷史訂單中偵測到多個基本貨幣
Cron作業analytics_collect_data遺失、失敗或卡在錯誤狀態

解決方法 resolution

按一下每個問題，即可顯示疑難排解員每個步驟的答案詳細資料。

步驟 1

您使用進階報告時是否遇到404錯誤，以及您的網站是否符合進階報告需求？

是 — 繼續進行步驟2。
否 — 依照進階報告需求中的步驟，完成您網站的進階報告需求。然後，繼續步驟2。

步驟 2

是否已使用多種基本貨幣（在訂單和設定中）？

注意：這個命令需要完整的資料表掃描，所以對於記錄數量高的資料表，當查詢執行以取得歷史訂單資料時，可能會影響效能。

是 — 如果SELECT value FROM core_config_data WHERE path = 'currency/options/base';傳回多個列，則不支援進階報告。我們只支援一種貨幣。您必須改用Adobe Commerce Intelligence。請洽詢您的帳戶團隊以設定此專案。
否 — 如果只顯示一種貨幣（例如USD），請使用SELECT DISTINCT base_currency_code FROM sales_order;檢查歷史訂單。如果曾經存在多種貨幣，則不支援進階報告。否則，請繼續步驟3。

步驟 3

進階報告是否已啟用？檢查管理員 > 個存放區 > 設定 > 組態 > 一般 > 進階報告。如需詳細步驟，請檢閱進階報告：啟用進階報告。

是 — 繼續進行步驟4。
否 — 在管理員中啟用進階報告 > 個存放區 > 設定 > 組態 > 一般 > 進階報告。等待24小時進行同步。若載入資料，問題即已解決；若未載入，請繼續執行步驟4。

步驟 4

設定中是否有權杖？執行查詢SELECT * FROM core_config_data WHERE path LIKE 'analytics/general/token' \G以進行檢查。

是 — 繼續進行步驟6。
NO — 如果Token為NULL或遺失，請繼續執行步驟5。

步驟 5

查詢是否傳回flag表格中的列？

是 — 執行DELETE FROM flag WHERE flag_code = 'analytics_link_subscription_update_reverse_counter';刪除列，停用/啟用進階報告，重新授權Token，等待24小時。如果仍然中斷，送出支援票證。
否 — 停用/啟用進階報告，重新授權Token，等待24小時。如果仍然中斷，送出支援票證。

步驟 6

cron_schedule資料表中是否有任何記錄，以及是否已執行analytics_collect_data工作（使用SELECT * FROM cron_schedule WHERE job_code LIKE 'analytics_collect_data' \G檢查）？

是 — 如果狀態=遺漏，這表示analytics_collect_data 未如預期執行。受支援的Adobe Commerce版本仍可能發生此問題，因為工作原本在預設cron群組中執行。套用QPT修補程式MDVA-19640。套用之前，請升級至最新版的「品質修補工具」(QPT)。請遵循官方QPT使用指南中的修補程式應用程式指示：
- QPT使用指南
- QPT發行說明： v1.0.20 (MDVA-19640已在v1.0.20中新增)。
是 — 如果狀態=成功，請繼續進行步驟8。
是 — 如果狀態= error，表示作業嘗試執行但發生錯誤。繼續步驟7以取得進一步的診斷。
否 — 找不到記錄。工作從未執行。繼續進行步驟7。

步驟 7

工作是否已登入support_report.log？

是 — 如果成功，請繼續執行步驟8。
否 — 提交支援票證。

步驟 8

檔案data.tgz是否存在於系統中，以及存取記錄中有記錄嗎？

若要檢查檔案data.tgz是否存在，請執行此命令 — 它應該傳回具有雜湊名稱的目錄：

code language-none
`ls -ltr pub/media/analytics/`

若要檢查access.log中是否有記錄，請執行此命令：

在Commerce Cloud上：

code language-none
`zgrep -i analytics /var/log/platform//access.log \| grep MagentoBI`

內部部署：會相應取代檔案路徑：

code language-none
`zgrep -i analytics <your web server's log path>/access.log* \| grep MagentoBI`

是 — 如果檔案data.tgz存在且存取記錄中有記錄，但您仍然有404錯誤，則您需要提交支援票證。
否 — 繼續步驟9。

步驟 9

cron作業是否擲回錯誤訊息？

範例：在cron_schedule表格中，您看到錯誤無法刪除"/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850c0檔案。警告！ unlink(https://experienceleague.adobe.com/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850%EF%BC%9Flang=en?lang=zh-Hant)：沒有這樣的檔案或目錄"

是 — 此問題會透過ECE工具隨附的雲端修補程式，自動在雲端上的Adobe Commerce上解決。不需要手動動作。對於內部商家，無法透過「品質修補工具」(QPT)取得此修正。如果錯誤持續發生，請提交支援票證。
否 — 提交支援票證。