集計されない

集計に関する問題の対処方法をまとめました。

集計が開始できない

• 初期セットアップ（CRON設定）が未完了 — 初期セットアップ を完了
• 別の集計が実行中 — 完了または失敗するまで待機
• コマンドで集計を実行中 — 管理画面からは進捗確認のみ
• 未来の日付を指定している — 前日以前の日付を指定

集計が「定期実行の開始待ち」のまま進まない

• 集計用の定期実行（eccube:crm-analytics42:worker）が登録・動作しているか確認
• 推奨スケジュールは5分おき（*/5 * * * *）です。登録間隔によっては、開始まで最大でその分の待ち時間があります
• さくらのレンタルサーバーの場合は さくらのレンタルサーバーでのCRON設定 を確認
• 集計用コマンドに --no-debug が付いているか確認
• EC-CUBE設置パスがCRONコマンド内で正しいか確認
• ダッシュボードで「動作を確認しました」と表示されるか確認
• サーバーのCRONログや app/PluginData/CrmAnalytics42/worker/last_success_at を確認

集計が失敗した

• 進捗パネルまたは集計ログの「エラー内容をコピー」ボタンで情報を取得
• コピー内容（集計ログID・期間・エラーメッセージ）をもとに原因を調査
• メモリ不足の場合 — 集計用コマンドに --no-debug を付けて再実行
• 同じ期間を短く分けて再実行

集計が途中で止まった

• 2時間以上進捗が更新されない場合 — 自動的に「失敗」に変更。対象期間を再実行
• 集計用の定期実行が停止していないか確認（5分おき実行の設定）
• 正常実行中の会員サマリ集計はリースが更新されるため、2時間以内に失敗扱いにはなりません

集計完了後もデータが表示されない

• ブラウザの再読み込みを試す
• 集計ログで「完了」を確認
• 初期セットアップが完了していること（分析画面のガードが解除されていること）
• 集計対象期間と分析画面の表示期間が一致しているか確認
• 受注の order_date・customer_id などがNULLだらけでないか確認

集計は完了したがSlack通知が来ない

• Slack通知は手動集計ではなく、CRONで実行された日次集計が対象です
• 設定画面でSlack通知がON、Webhook URLが正しいか確認します
• 通知時刻前であれば、送信待ちのままになることがあります
• 集計用の定期実行が継続して動いているか確認します