← Network Error Logging / network-error-logging

Network Error Logging

Network Error Logging (NEL) je systém hlášení fungující na úrovni prohlížeče, který uživatelům umožňuje hlásit vlastní výpadky na externí endpoint. Pomocí Network Error Logging můžete lépe porozumět problémům s připojením na internetu a zjistit, kdy a kde k incidentu dochází, koho postihuje a jak se projevuje.

Poslední míle je cesta od uživatele k prvnímu vstupnímu bodu do zdroje, ať už jde o síť jako Cloudflare, nebo přímo o origin server. Poslední míle je důležitá, protože leží na kritické cestě požadavku na daný zdroj: pokud na poslední míli nastanou problémy, uživatelé se ke svým zdrojům nemohou připojit. Když máte povoleno Network Error Logging, můžete dostávat upozornění na problémy na poslední míli, které se jinak obvykle obtížně odhalují, a zjistit tak, v čem problém spočívá a jak jej vyřešit.

Hlavička Report-To je přítomna ve všech požadavcích na zóny Cloudflare, které mají povoleno NEL:  

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)`"}]}

Ukázkový payload zprávy Network Error Report vypadá takto:

{
  "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 pomocí geolokačních vyhledávání získává z každé klientské IP adresy v hlášení NEL následující informace:

• Client ASN
• Client country
• Client metro area

Cloudflare pomocí interních vyhledávání přiřazuje uvedená data k doméně a účtu zákazníka.

Cloudflare neukládá žádné osobní údaje (PII) ani data specifická pro uživatele a IP data uchovává pouze po dobu zpracování požadavku. Jakmile je zpráva zpracována v rámci pipeline NEL, všechna data PII jsou ze systému odstraněna.

IP adresa klienta se uchovává pouze ve volatilní paměti po dobu trvání požadavku na endpoint NEL Cloudflare (v řádu milisekund) a po dokončení požadavku je okamžitě odstraněna. Cloudflare IP adresu klienta nikde v rámci pipeline Network Error Logging nezaznamenává.

Hlášení NEL obsahují informace o síťových podmínkách koncového uživatele, které lze považovat za citlivé. Cloudflare bere ochranu soukromí vážně a zavedla následující opatření:

• Hlášení se odesílají do infrastruktury Cloudflare a nesdílejí se s třetími stranami.
• Hlášení neobsahují osobní údaje (PII).
• Zákazníci se mohou odhlásit z toho, aby jejich koncoví uživatelé využívali hlavičky NEL, a to jedním z následujících způsobů:
  1. Samoobslužně (nastavení zóny) : Použijte přepínač v dashboardu nebo API (PATCH /zones/{zone_id}/settings/nel) a deaktivujte NEL pro svou zónu. Toto nastavení může kdykoli znovu povolit kterýkoli správce zóny.
  2. Trvalé odhlášení přes podporu : Kontaktujte podporu Cloudflare, aby byl nel___enable feature flag zakázán na úrovni produktu. Tím se zabrání tomu, aby bylo možné NEL na vaší zóně vůbec povolit, a správci zóny toto nastavení nemohou vrátit zpět. U plánů Free a Pro obvykle stačí přepínač v dashboardu. Zákazníci na plánu Enterprise s přísnými požadavky na ochranu soukromí mohou dát přednost trvalému odhlášení na úrovni podpory.