Skip to main content

プライバシーとコンプライアンス

このプラグインは、ユーザーのプライバシーを尊重しながらアナリティクスと連携するように設計されています。
  • Cookie なし: 純粋なサーバーサイドの実装
  • JavaScript なし: クライアントサイドのトラッキングコードなし
  • データの最小化: HTTP メタデータのみで、コンテンツは含まない
  • 自動秘匿化: 機密性の高いパラメーターを削除
  • 公開ページのみ: 管理エリアとユーザーエリアを除外
正確なボット検出とトラフィック分析に不可欠であるため、完全な IP アドレスが収集されます。お住まいの法域で IP の匿名化が求められる場合は、追加の設定が必要になることがあります。

データ収集

プラグインは、公開ページから標準的な HTTP リクエストのメタデータを収集します。

必須フィールド

Agent Analytics に送信されるすべてのログエントリには、次のフィールドが必須です。
ログを正常に取り込むには、すべての必須フィールドが存在する必要があります。フィールドが欠けていると、API 側で検証エラーになります。

任意フィールド

次のフィールドは、利用可能な場合に含まれますが、必須ではありません。
プラグインは、ページのコンテンツ、フォームデータ、WordPress のユーザー情報、管理アクティビティ、データベースクエリ、その他サーバーサイドのアプリケーションデータを収集しません。

パスの自動フィルタリング

常に除外されるパス

次のパスはログから自動的に除外され、上書きすることはできません。
これらの除外は部分文字列の一致を使用するため、WordPress のインストールディレクトリに関係なく機能します (例: /blog/wp-admin/ も除外されます)。

リクエストタイプによる除外

プラグインは次のものを自動的にスキップします。
  • 管理画面からの参照リクエスト: Referer に wp-admin を含むすべてのリクエスト
  • REST API 呼び出し: rest_route=/wp/* クエリパラメーターを含むリクエスト
  • CLI 操作: WP-CLI コマンド
  • 編集コンテキスト: context=edit パラメーターを含む REST リクエスト

パスフィルタリングの優先順位

パスは次の順序で評価されます。
  1. 組み込みの除外 (wp-admin、wp-login.php など)
  2. カスタムの除外パス (ユーザーが設定したパターン)
  3. Referer のチェック (wp-admin からのリクエスト)
  4. REST API のチェック (WordPress コア API)
最初に一致したものが優先されます。いずれかのチェックに一致した場合、そのリクエストは除外されます。

クエリパラメーターの秘匿化

デフォルトで秘匿化されるパラメーター

次のクエリパラメーターのキーは自動的に秘匿化されます ([REDACTED] に置き換えられます)。
秘匿化には部分文字列の一致が使用されます。これらの文字列を含むパラメーターはすべて秘匿化されます (例: user_password、api_token、card_number)。

秘匿化の例

元のクエリ文字列:
秘匿化後:

Log Ingestion Token のセキュリティ

保存方法

プラグインは、Log Ingestion Token の設定方法として 3 つの方法をサポートしています。セキュリティの観点で推奨される順に示します。
サーバーの環境に追加します。
または wp-config.php に追加します。
本番環境では、環境変数または定数を使用してください。データベースへの保存は、テスト時やファイルへのアクセスが制限されている場合にのみ使用してください。

IP アドレスの取り扱い

検出の順序

プラグインは、次の順序で実際のクライアント IP の検出を試みます。
  1. HTTP_X_FORWARDED_FOR - リスト内の最初の IP (プロキシ/ロードバランサー用)
  2. HTTP_CF_CONNECTING_IP - Cloudflare の実 IP ヘッダー
  3. HTTP_X_REAL_IP - 代替のプロキシヘッダー
  4. HTTP_TRUE_CLIENT_IP - Cloudflare Enterprise のヘッダー
  5. REMOTE_ADDR - 直接接続 (フォールバック)
プラグインは、マネージド WordPress ホスト (WP Engine、Kinsta など) や CDN (Cloudflare、Fastly) が使用するリバースプロキシを自動的に処理します。

IP のプライバシーに関する考慮事項

  • 匿名化なし: 正確なボット検出のため、完全な IP アドレスが取得されます
  • サービスに必須: IP データは、地理的分析や逆引き DNS ルックアップに不可欠です
  • GDPR への準拠: IP データの収集に関する法的要件を考慮してください

設定オプション

一般設定

プライバシー設定

詳細設定

カスタムパスフィルタリング

ワイルドカードパターンの例

次のようなパターンを使用して、カスタムのパス除外を追加できます。

データ保持

プラグイン側の保持

  • キューのエントリ: 送信が成功すると削除されます
  • 失敗したエントリ: 指数バックオフで最大 6 回再試行されます
  • 古いエントリ: 保持期間 (デフォルトは 7 日) を過ぎると自動的にクリーンアップされます
  • キューの上限: 上限 (100,000) に達すると、最も古いエントリから破棄されます

API 側の処理

  • 成功したログ: Agent Analytics によって即座に処理されます
  • 検証エラー: 記録されますが、エントリはキューから削除されます
  • 認証の失敗: キューが一時停止され、サーキットブレーカーが作動します

パフォーマンス特性

  • 処理のオーバーヘッド: 1 リクエストあたり 1ms 未満
  • メモリ使用量: 最小限 (1 リクエストあたり 1 つの配列)
  • データベース操作: 1 リクエストあたり 1 回の INSERT
  • 出力バッファリングなし: レスポンスの配信を遅延させません
  • 送信間隔: 60 秒ごと (設定可能)
  • バッチサイズ: 1 回の送信あたり最大 500 件のログ (設定可能)
  • タイムアウト: 1 バッチあたり最大 5 秒
  • キューの上限: 最大 100,000 エントリ
  • 自動再試行: 失敗時に指数バックオフで再試行
  • サーキットブレーカー: 3 回連続で失敗すると一時停止
  • キューの永続化: 障害発生時もログを保持
  • ロック機構: 同時処理を防止

セキュリティのベストプラクティス

  • 本番サイトでは、Log Ingestion Token をデータベースではなく環境変数に保存してください。
  • サイトのすべての機密エリアがログから除外されていることを確認してください。
  • Status タブを定期的に確認し、ログが正しく送信されていることを確認してください。
  • 「Send Test Event」機能を使用して、実際のデータに影響を与えずに接続を確認してください。
  • サーバーへの転送中のデータを保護するため、WordPress サイトで HTTPS を使用してください。
セキュリティ上の問題を発見した場合や設定についてサポートが必要な場合は、直ちに support@tryprofound.com までお問い合わせください。