短い回答: リアルタイム表示は5秒以内に更新されます。事前集計レポート(メインダッシュボード、地理的内訳、トップページテーブル)は1~2分のサイクルで更新されます。
タイミングの完全な内訳
| サーフェス | 通常の遅延 | 理由 |
|---|---|---|
| Liveタブ | 5秒未満 | ライブ訪問者エンドポイントを約5秒ごとにポーリング |
| 3D地球儀 | 5秒未満 | Supabase RealtimeでWebSocket経由でストリーム |
| 訪問者カウンター(ヘッダー) | 10秒未満 | 短いTTLのCloudflare KV |
| メインダッシュボードチャート | 1~2分 | クエリ速度のために事前集計 |
| トップページ/ソース/国 | 1~2分 | 事前集計 |
| 日次合計(analytics_daily) | 最大5分 | 短いウィンドウのジョブで集計 |
| リテンション/コホートチャート | 5~15分 | より高コスト;遅いサイクルで計算 |
| CSV/JSONエクスポート | 最大15分 | 最新のロールアップから抽出 |
「リアルタイム」が実際に意味するもの
訪問者のブラウザでトラッカーがtrackを発火すると、リクエストは50~100ミリ秒でCloudflare Workers(最寄りのエッジPOP)に到達し、検証されてEUプライマリーデータベースに転送され、数秒以内にあなたのリアルタイム表示に表示されます。
これがLiveタブと3D地球儀が即時に感じられる理由です。地球儀はSupabase Realtime経由でデータベースストリームに直接サブスクライブし、Liveタブはアクティブな訪問者リストを数秒ごとに更新します。
メインチャートに1~2分の遅延がある理由
「過去24時間のページビュー」のようなチャートは、ダッシュボードを読み込むたびに完全なテーブルスキャンを実行しません。代わりに、小さなバックグラウンドジョブが1~2分ごとにイベントを事前計算された時間バケットにロールアップします。これにより、月間数百万イベントを持つサイトでもダッシュボードが高速になります — 小さなラグの代償で。
新しいイベントが到着したことを確認したい場合は、メインチャートではなくLiveタブを見てください。
2分以上を期待すべき場合
長い遅延の正当な理由:
- 重いフィルタの組み合わせ — 5+のフィルタを適用すると、事前集計よりも遅い直接クエリにフォールバックする場合があります。
- 「現在」を含むカスタム日付範囲 — 一部の日付ピッカーはオンザフライで再集計します。
- リテンションおよびコホートレポート — 設計上、5~15分の周期で計算されます。
- 最近識別された訪問者 — 匿名セッションとログインユーザーの間のリンクは非同期で処理され、最大1分かかる場合があります。
トラブルシューティング
5分経ってもイベントがまだLiveタブに表示されない場合、問題はインストール側(スクリプトが読み込まれていない、広告ブロッカー、トラッキングコードが間違っている)にある可能性が最も高いです — 最初のイベントが表示されないおよびインストールの確認を参照してください。