← Network Error Logging / network-error-logging

Network Error Logging

Network Error Logging (NEL) представляет собой систему отчетности на стороне браузера, которая позволяет пользователям сообщать о собственных сбоях на внешнюю конечную точку. С помощью Network Error Logging можно получить представление о проблемах с подключением в интернете, узнать, когда и где происходит инцидент, кого он затрагивает и как именно это происходит.

Последней милей называется путь от пользователя до первой точки входа в ресурс, будь то сеть вроде Cloudflare или сам исходный сервер напрямую. Последняя миля важна, потому что она находится на критическом пути запроса к ресурсу: если на последней миле возникают проблемы, пользователи не могут подключиться к своим ресурсам. Если включить Network Error Logging, вы можете получать оповещения о проблемах на последней миле, которые обычно трудно обнаружить, и узнавать, в чем именно проблема и как ее устранить.

Заголовок Report-To присутствует во всех запросах к зонам Cloudflare, для которых включен 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)`"}]}

Пример содержимого отчета 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 использует геолокационные запросы, чтобы извлечь следующую информацию из каждого клиентского IP-адреса в отчете NEL:

• ASN клиента
• Страна клиента
• Городская агломерация клиента

Cloudflare использует внутренние запросы, чтобы связать эти данные с доменом и аккаунтом клиента.

Cloudflare не хранит PII или данные, относящиеся к конкретному пользователю, а данные IP-адреса сохраняются только на время обработки запроса. После обработки отчета в конвейере NEL все данные PII удаляются из системы.

IP-адрес клиента хранится только в оперативной памяти на время обработки запроса к конечной точке NEL Cloudflare (порядка миллисекунд) и удаляется сразу после завершения запроса. Cloudflare нигде не логирует IP-адрес клиента в конвейере Network Error Logging.

Отчеты NEL содержат информацию о состоянии сети конечного пользователя, которая может считаться конфиденциальной. Cloudflare серьезно относится к вопросам конфиденциальности и реализовала следующие меры защиты:

• Отчеты отправляются в инфраструктуру Cloudflare и не передаются третьим лицам.
• Отчеты не содержат персональных данных (PII).
• Клиенты могут отказаться от того, чтобы их конечные пользователи получали заголовки NEL, одним из следующих способов:
  1. Самостоятельно (настройка зоны): используйте переключатель на панели управления или API (PATCH /zones/{zone_id}/settings/nel) чтобы отключить NEL для вашей зоны. Эту настройку может в любой момент снова включить любой администратор зоны.
  2. Постоянный отказ через поддержку: обратитесь в поддержку Cloudflare, чтобы отключить nel___enable флаг функции, отключенный на уровне продукта. Это полностью запрещает включение NEL для вашей зоны, и администраторы зоны не могут отменить это ограничение. Для планов Free и Pro обычно достаточно переключателя на панели управления. Клиентам Enterprise со строгими требованиями к конфиденциальности может подойти постоянный отказ на уровне поддержки.