适用于Adobe Commerce的高级报表疑难解答程序

本文提供了一个结构化的故障诊断决策树,用于诊断和解决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。 请联系您的帐户团队以进行此设置。
  • NO — 如果只显示一种货币(例如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 — 如果令牌为NULL或缺失,请继续执行步骤5。

步骤 5

查询是否返回flag表中的行?

步骤 6

cron_schedule表中是否有任何记录,是否执行了analytics_collect_data作业(使用SELECT * FROM cron_schedule WHERE job_code LIKE 'analytics_collect_data' \G检查)?
  • YES — 如果状态=缺失,则表示analytics_collect_data 未按预期执行。  此问题在受支持的Adobe Commerce版本中仍可能发生,因为作业最初在默认cron组中运行。 应用QPT修补程序MDVA-19640。 在应用之前,请升级到最新版本的Quality Patches Tool (QPT)。 按照官方的QPT使用指南中的修补程序应用程序说明进行操作:

  • 是 — 如果状态=成功,则继续执行步骤8。

  • 是 — 如果状态= error,则作业尝试运行但遇到错误。 请执行步骤7以进一步诊断。

  • 否 — 未找到记录。 这项工作从未执行过。 继续执行步骤7。

步骤 7

作业是否已登录support_report.log

步骤 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-Hans):没有此类文件或目录“

  • 是 — 通过ECE工具附带的云修补程序,可在Adobe Commerce on Cloud上自动解决此问题。 无需手动操作。 对于本地商家,无法通过Quality Patches Tool (QPT)进行此修复。 如果错误仍然存在,请提交支持票证
  • 否 — 提交支持票证

相关阅读

Commerce管理员入门指南中的高级报告

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f