cairn

Cairnは、Laravelアプリケーションにウェブ解析機能を直接追加するComposerパッケージです。インストールはcomposer requireとphp artisan migrateを実行するだけで完了し、その後 /cairn でダッシュボードが利用可能になります。追跡はブラウザタグではなくアプリケーション内部で動作するため、ルート名、Eloquentモデル、認証済みユーザーに関するレポートが可能です。 プライバシーモデル：訪問者はソルト付きハッシュで識別され、このハッシュは24時間ごとに新しいランダムバイトから再生成され、以前のソルトは破棄されます。READMEにはその影響として、リピーターのカウント、数日間にわたるジャーニーやマルチタッチアトリビューション、デバイスを跨いだ追跡が不可能であることが明記されています。その代わり、デフォルト設定では訪問者のデバイスに何も保存せず、データベース、ログ、バックアップにIPアドレスを保持せず、クッキー同意バナーも不要です。解析テーブルからデータが漏洩しても、個人の特定ではなくカウント数のみが漏れることになります。デフォルトでオフになっている2つのオプション設定があり、privacy.track_user_idはログインユーザーにエントリを紐付け、privacy.durable_identityは回転するハッシュをクッキーに置き換えます。国別レポートもデフォルトではオフであり、リクエストごとのサードパーティ照会ではなく、cairn:geoipでダウンロードしたローカルのMaxMind GeoLite2ファイルを使用します。 ダッシュボードとレポート：ダッシュボードはサーバーレンダリングされたBladeで構成されており、JavaScriptなしで閲覧可能です。フィルタリングにはリンクを、チャートにはサーバーで計算されたインラインSVGを使用し、各チャートの下にテーブルを配置しています。デフォルトで18個のウィジェットが提供されており、設定を1行追加することでさらに3つのウィジェットを追加できます。ウィジェットはクラスとして実装されており、順序変更、削除、またはサブクラス化が可能です。ランキングテーブル用のディメンションウィジェットも含まれています。ダッシュボード、API、Pulseカード、CSVエクスポートを含むすべてのインターフェースは、単一のクエリレイヤーを介します。レポートビルダーは、ルートなどのディメンションでグループ化された訪問者数、ページビュー、直帰率などのメトリクスをサポートし、期間比較、ソート、制限が可能です。派生メトリクスは平均化されるのではなく、表示レベルで保存されたコンポーネントから再計算されます。また、ロールアップされていないデータをリクエストした場合は、生エントリをスキャンするのではなく例外をスローします。 運用：要件はPHP 8.2以上、Laravel 12または13、およびMySQL 8以上、MariaDB 10.6以上、またはPostgreSQL 13以上です。Redisはオプションであり、Redisベースのすべての機能には、同じテストスイートで検証された同等の正確性を持つデータベースベースのドライバーが用意されています。npm、Vite、Nodeのビルドステップは不要です。Artisanコマンドには、cairn:rollup、cairn:prune、cairn:work、cairn:partition、cairn:doctor、cairn:geoip、cairn:forget、cairn:exportがあります。RollupとPruneは自動的にスケジュールされますが、cronがないホストでは、少数のリクエストがこれらの処理を担います。ダッシュボードルートはviewCairnゲートで保護されており、定義されるまでローカル環境以外からのアクセスは拒否されます。ダッシュボードドライバーはblade（デフォルト）、livewire、inertia、noneが選択可能です。LivewireやInertiaは必須ではなく、インストールされていないドライバーを指定した場合はBladeダッシュボードが表示されます。オプションのビーコンにより、ページ滞在時間、スクロール深度、画面サイズ、Core Web Vitalsの測定が可能です。 範囲とライセンス：READMEには、数日間にわたるユーザー追跡、IPアドレスの保存、ファネル、コホート分析、ヒートマップ、セッションリプレイ、A/Bテスト、ラストクリック以外のアトリビューション、行動ベースのボット検出など、意図的に除外された目標がリストされています。また、Cairnが特定の規制への準拠を保証するものではないことが述べられています。プロジェクトは安定版とされており、1.0.0からセマンティックバージョニングに従い、MITライセンスで提供されています。