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

Advanced Reporting の使用時に 404 エラーが発生し、サイトが Advanced Reporting requirements を満たしているか。

対応 – ステップ 2 に進みます。
いいえ – 高度なレポート要件の手順に従って、サイトの高度なレポート要件を完了します。次に、手順 2 に進みます。

手順 2

複数の基本通貨を（注文および設定内で）使用していますか。

メモ：このコマンドでは、完全なテーブルスキャンが必要です。そのため、レコード数が多いテーブルの場合、クエリの実行中に注文の履歴データを取得する際にパフォーマンスに影響が及ぶ可能性があります。

対応 – SELECT value FROM core_config_data WHERE path = 'currency/options/base'; から複数の行が返された場合、高度なレポートはサポートされません。私たちは 1 つの通貨のみをサポートしています。代わりに 0}Adobe Commerce Intelligence} を使用する必要があります。これを設定するには、アカウントチームにお問い合わせください。
いいえ – 1 つの通貨（USD など）のみ表示される場合は、SELECT DISTINCT base_currency_code FROM sales_order; で注文履歴を確認してください。複数の通貨が存在した場合、高度なレポート機能はサポートされていません。それ以外の場合は、手順 3 に進みます。

手順 3

高度なレポート機能は有効になっていますか。「Admin」をオンにします。 > 店舗 > 設定 > 設定 > 一般 > 詳細レポート . 詳細な手順については、<> 詳細レポート：詳細レポートを有効にする <> を参照してください。

対応 – 手順 4 に進みます。
いいえ – Admin で 詳細レポートを有効にする > 店舗 > 設定 > 設定 > 一般 > 詳細レポート . 同期するまで 24 時間待ちます。データが読み込まれたら、問題が解決しました。読み込まれなかった場合は、手順 4 に進みます。

手順 4

設定にトークンはありますか？確認するクエリ SELECT * FROM core_config_data WHERE path LIKE 'analytics/general/token' \G を実行します。

対応 – 手順 6 に進みます。
いいえ – トークンが NULL または見つからない場合は、手順 5 に進みます。

手順 5

クエリはテーブルの行を返 flag ますか？

対応 – DELETE FROM flag WHERE flag_code = 'analytics_link_subscription_update_reverse_counter'; を実行して行を削除、詳細レポートを無効化/有効化、トークンを再認証、24 時間待ちます。それでも問題が解決しない場合は、サポートチケットを送信してください。
いいえ – 詳細レポートを無効/有効にする、トークンを再認証し、24 時間待ちます。それでも問題が解決しない場合は、サポートチケットを送信してください。

手順 6

cron_schedule テーブルにレコードがありますか。また、analytics_collect_data ジョブは実行されましたか（SELECT * FROM cron_schedule WHERE job_code LIKE 'analytics_collect_data' \G を使用して確認してください）。

はい – ステータス =が欠落の場合、analytics_collect_data が期待どおりに実行されなかったことを示します。ジョブが最初にデフォルトの cron グループで実行されたため、サポートされているAdobe Commerce バージョンでも、この問題が発生する可能性があります。 QPT パッチ MDVA-19640 を適用します。適用する前に、Quality Patches Tool （QPT）の最新バージョンにアップグレードしてください。公式の QPT 使用ガイドにあるパッチアプリケーションの手順に従います。
- QPT 使用ガイド
- QPT リリースノート：v1.0.20 （v1.0.20 で MDVA-19640 が追加されました）。
対応 – ステータス =成功の場合は、手順 8 に進みます。
はい – ステータス = エラーの場合、ジョブの実行を試みましたが、エラーが発生しました。詳細な診断については、手順 7 に進みます。
いいえ – レコードが見つかりません。ジョブは実行されません。手順 7 に進みます。

手順 7

ジョブは support_report.log にログインしましたか？

対応 – 成功した場合は、手順 8 に進みます。
いいえ – サポートチケットを送信。

手順 8

ファイル data.tgz はシステムに存在し、アクセスログにレコードがありますか。

ファイル data.tgz が存在することを確認するには、次のコマンドを実行します。このコマンドは、ハッシュ名を持つディレクトリを返します。

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

access.logs にレコードがあることを確認するには、次のコマンドを実行します。

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 （/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850?lang=en）：そのようなファイルやディレクトリはありません」

対応 – この問題は、ECE ツールに含まれる Cloud パッチを通じて、Adobe Commerce on Cloud で自動的に解決されます。手動アクションは必要ありません。オンプレミスのマーチャントの場合、この修正は Quality Patches Tool （QPT）では使用できません。エラーが解決しない場合は、サポートチケットを送信してください。
いいえ – サポートチケットを送信。