Adobe Commerceの高度なレポート機能のトラブルシューティング
この記事では、Adobe Commerceの高度なレポートの問題を診断および解決するための構造化トラブルシューティングのデシジョンツリーを提供します。 ターゲットを絞った診断に関する質問の答えを示し、回答にもとづいて関連するクエリ、パッチ、ドキュメントを提示します。 ワークフローは、設定のギャップ、通貨の不一致、トークンの問題、cron関連のエラーなどの根本原因を特定するのに役立ちます。
説明 description
環境
Adobe Commerce on Cloud Infrastructure
問題/症状
- 高度なレポート ダッシュボードにデータが表示されない
- 詳細レポートへのアクセス時に404 エラーが発生しました
- Adobe Commerceと高度なレポート間の同期遅延
- 設定にトークンが見つからないか、無効です
- 構成または過去の注文で複数の基本通貨が検出されました
- Cron ジョブ analytics_collect_dataが見つからないか、失敗したか、エラー状態で停止しました
解決策 resolution
各質問をクリックすると、トラブルシューティングの各ステップの回答の詳細が表示されます。
手順 1
- はい – ステップ 2に進みます。
- いいえ – 詳細レポート要件の手順に従って、サイトの詳細レポート要件を完了します。 次に、手順2に進みます。
手順 2
SELECT value FROM core_config_data WHERE path = 'currency/options/base';を実行して確認します。メモ：このコマンドにはテーブル全体のスキャンが必要なので、レコード数が多いテーブルの場合、クエリの実行中に過去の注文データを取得する際にパフォーマンスに影響が生じる可能性があります。
- はい –
SELECT value FROM core_config_data WHERE path = 'currency/options/base';によって複数の行が返された場合、高度なレポートはサポートされていません。 1つの通貨のみをサポートします。 代わりにAdobe Commerce Intelligenceを使用する必要があります。 設定については、アカウントチームにお問い合わせください。 - いいえ – 1つの通貨（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
SELECT * FROM flag WHERE flag_code = 'analytics_link_subscription_update_reverse_counter';を実行して確認します。- はい –
DELETE FROM flag WHERE flag_code = 'analytics_link_subscription_update_reverse_counter';を実行して行を削除し、詳細レポートを無効にして再度有効にし、トークンを再認証して24時間待ちます。 問題が解決しない場合は、 サポートチケットを送信してください。 - いいえ – 高度なレポートを無効にして再度有効にし、トークンを再認証し、24時間待ちます。 問題が解決しない場合は、 サポートチケットを送信してください。
手順 6
SELECT * FROM cron_schedule WHERE job_code LIKE 'analytics_collect_data' \Gを実行して確認します。-
YES - ステータス =が欠落している場合は、これは
analytics_collect_dataが期待どおりに実行されなかったことを示します。 この問題は、最初にデフォルトのcron グループで実行されたため、サポートされているAdobe Commerce バージョンでも発生する可能性があります。 QPT パッチ MDVA-19640を適用します。 適用する前に、最新バージョンの品質パッチツール（QPT）にアップグレードしてください。 公式QPT使用ガイドのパッチアプリケーションの手順に従ってください。- QPT使用ガイド
- QPT リリースノート：v1.0.20 （MDVA-19640はv1.0.20に追加されました）。
-
はい – ステータス =成功の場合は、手順8に進みます。
-
YES - ステータス = エラーの場合、ジョブは実行を試みましたが、エラーが発生しました。 さらに診断を行うには、手順7に進みます。
-
NO - レコードが見つかりません。 その仕事は一度も始まらなかった。 手順7に進みます。
手順 7
analytics_collect_data ジョブはsupport_report.logにログインしましたか？Adobe Commerce on Cloudでは、ログは複数のweb ノードで生成でき、サーバー上の1つのローカルファイルに同期されないため、New Relic ログを使用して確認することをお勧めします。 New Relicでは、ノードごとのログとローテーションされたログが1か所に集約されます。
New Relicで、 ログ に移動し、クエリ filePath:"/data/exports/local/%project_id%/log/support_report.log" message:"*analytics_collect_data"を実行します。
代替/手動チェックとして、zgrep analytics_collect_data var/log/support_report.log*を実行します。
- YES - ジョブが正常にログに記録された場合は、手順8に進みます。
- いいえ – サポートチケットを送信。
手順 8
ls -ltr pub/media/analytics/を実行してファイルを確認し、zgrep -i analytics /var/log/platform/*/access.log* | grep MagentoBI （クラウド）または同等のaccess.log コマンドをオンプレミスで実行してログを確認します。- はい – ファイル
data.tgzが存在し、アクセス ログにレコードが含まれていても、404 エラーが引き続き発生する場合は、 サポートチケットを送信する必要があります。 - いいえ – ステップ 9に進みます。
手順 9
cron_schedule テーブルを確認してください。例：cron_schedule テーブルに「/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850c0 ファイルを削除できません」というエラーが表示される。 警告！ unlink （/app/var/tmp/analytics/tmp/.nfsb3b6041dd44588a0000850?lang=en）：そのようなファイルまたはディレクトリはありません"
- はい – この問題は、ECE ツールに含まれているCloud パッチを通じて、Adobe Commerce on Cloudで自動的に解決されます。 手作業による操作は必要ありません。 オンプレミスのマーチャントの場合、この修正は品質パッチツール（QPT）を通じて使用できません。 エラーが解決しない場合は、 サポートチケットを送信してください。
- いいえ – サポートチケットを送信。
関連トピックス
Commerce管理者向け入門ガイドの高度なレポート 。