Construtor de NEL (Network Error Logging)

Toda ferramenta de monitoramento tem um ponto cego: ela mede o que chegou. Requisição que falhou por DNS, por conexão recusada, por certificado inválido ou por rede caída nunca aparece nos seus registros, porque nunca chegou. O mecanismo de registro de erro de rede fecha essa lacuna — é o próprio navegador que reporta a falha, depois, quando voltar a ter conexão.

Preencha o grupo, a URL do coletor e as taxas de amostragem, e a página monta os dois cabeçalhos necessários. São dois porque as responsabilidades são separadas: um declara o grupo de coleta e para onde enviar, o outro liga o registro e diz que fração dos casos reportar. Faltar um dos dois é o motivo mais comum de configuração que não produz relatório nenhum.

As taxas de amostragem merecem atenção. A de sucesso costuma ficar bem baixa, porque requisição bem-sucedida é a maioria esmagadora e reportar todas geraria volume enorme sem informação nova. A de falha costuma ficar em cem por cento, já que falha é rara e é exatamente o que se quer ver. Vale notar que o coletor precisa aceitar requisições de outra origem, e que ele próprio não deve estar no domínio monitorado — se a rede do domínio cair, o relatório não sairia.