Network Error Logging

Network Error Logging（NEL）は、ブラウザーベースのレポートシステムです。ユーザー自身の失敗を外部エンドポイントへ報告できます。Network Error Logging を使うと、インターネット上の接続の問題を把握し、インシデントがいつどこで起きているか、誰がどのように影響を受けているかを確認できます。

ラストマイル

ラストマイルは、ユーザーからリソースへの最初の入口までの経路です。入口は Cloudflare のようなネットワーク、またはオリジンサーバー直結のいずれかです。ラストマイルは重要です。リソース要求のクリティカルパス上にあるためです。ラストマイルに問題があると、ユーザーはリソースに接続できません。Network Error Logging を有効にすると、通常は検出しにくいラストマイルの問題についてアラートを受け取れ、何が問題でどう直すかを把握できます。

NEL がリクエストに与える影響

NEL が有効な Cloudflare ゾーンへのすべてのリクエストに、Report-To ヘッダーが含まれます。

report-to: {"group":"cf-nel","max_age":31536000,"endpoints":[{"url":"`[`https://a.nel.cloudflare.com/report?lkg-colo=lhr&lkg-time=1600338181`](https://gcp.nel.cloudflare.com/report?lkg-colo=lhr&lkg-time=1600338181&lkg-ip=1.1.1.1)`"}]}

Network Error Report のペイロードの例は次のとおりです。

{
  "age": 20,
  "type": "network-error",
  "url": "https://example.com/previous-page",
  "body": {
    "elapsed_time": 18,
    "method": "POST",
    "phase": "dns",
    "protocol": "http/1.1",
    "referrer": "https://example.com/previous-page",
    "sampling_fraction": 1,
    "server_ip": "",
    "status_code": 0,
    "type": "dns.name_not_resolved",
    "url": "https://example-host.com/"
  }
}

プライバシー

Cloudflare は、NEL レポート内のすべてのクライアント IP に対して位置情報ルックアップを行い、次の情報を抽出します。

クライアント ASN
クライアントの国
クライアントのメトロエリア

Cloudflare は内部ルックアップを使い、上記のデータを顧客ドメインと顧客アカウントに関連付けます。

Cloudflare は個人を特定できる情報（PII）やユーザー固有のデータを保存しません。IP データは、処理中のリクエストの間だけ保持します。レポートが NEL パイプラインで処理されたあと、すべての PII データはシステムから削除されます。

クライアント IP アドレスは、Cloudflare の NEL エンドポイントへのリクエストの存続期間（ミリ秒単位）だけ揮発性メモリに保存され、リクエスト完了直後に破棄されます。Cloudflare は、Network Error Logging パイプラインのどこにもクライアント IP アドレスを記録しません。

NEL レポートにはエンドユーザーのネットワーク状況に関する情報が含まれ、機微と見なされることがあります。Cloudflare はプライバシーを重視し、次の保護を実装しています。

レポートは Cloudflare のインフラストラクチャへ送られ、サードパーティとは共有しません。
レポートに個人を特定できる情報（PII）は含まれません。
顧客は、次のいずれかの方法で、エンドユーザーが NEL ヘッダーを消費しないようオプトアウトできます。
1. セルフサービス（ゾーン設定） — ダッシュボードのトグルまたは API（PATCH /zones/{zone_id}/settings/nel）で、ゾーンの NEL を無効にします。ゾーン管理者はいつでも再有効化できます。
2. サポートによる恒久的なオプトアウト — Cloudflare サポートに連絡し、製品レベルで nel___enable 機能フラグを無効にします。これによりゾーンで NEL を有効にできなくなり、ゾーン管理者は元に戻せません。

Free および Pro プランでは、通常はダッシュボードのトグルで十分です。厳格なプライバシー要件がある Enterprise のお客様は、サポートレベルの恒久的なオプトアウトを選べます。