Configurar eventos AjaxRequest

Na versão 1211 do agente ou superior, todos os requests de rede feitos por uma página são registrados como eventos AjaxRequest. Você pode configurar quais requests são registrados e quais dados são capturados:

• Lista de negação: filtra quais domínios e URLs são excluídos do rastreamento AJAX
• Captura de carga: registre os dados completos de solicitação e resposta para depurar falhas

Lista de negações

Por padrão, registramos eventos AjaxRequest para todas as solicitações de rede feitas pelo seu aplicativo.

• Para parar de registrar todos os eventos, adicione um único caractere curinga * (asterisco).
  • Exemplo: *
• Para parar de registrar eventos para um site completo, adicione o nome do domínio.
  • Exemplo: mywebsite.com
• Para parar de registrar eventos para uma página específica, adicione o domínio e o caminho.
  • Exemplo: mywebsite.com/photos
• Começando com a versão 1.307.0 do agente, em qualquer lugar que encontrarmos um * (asterisco), corresponderemos a qualquer comprimento de string.
  • Exemplo: mywebsite.com/shop/* (para um caminho), *.mywebsite.com (para um subdomínio), mywebsite.com/*/shop/*/checkout (para strings de URL intermediárias).

O protocolo, a porta, a pesquisa e o hash de um URL são ignorados pela lista de negação.

Acesse a lista de negações

Para atualizar a lista de URLs negados que seu aplicativo filtrará na criação do evento, acesse a página de configurações do aplicativo:

1. Vá para one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings.
2. Na seção AJAX data capture settings, no campo Deny list, adicione os filtros que você gostaria de aplicar ao seu aplicativo.
3. Selecione Save para atualizar a configuração do agente.
4. Reimplante o agente browser (reiniciando o agente APMassociado ou atualizando a instalação de copiar/colar do browser).

Validar filtros de lista de negação

Para validar se os filtros adicionados funcionam conforme o esperado, execute uma consulta NRQL para AjaxRequest evento correspondente ao seu filtro.

FROM AjaxRequest SELECT * WHERE requestUrl LIKE '%example.com%'

Dados de captura de carga

Você pode habilitar a captura de carga para todos os requests ou apenas para requests com falha. Quando habilitado, o agente do browser captura as cargas de request e resposta para todas as chamadas AJAX para todos os domínios permitidos. Isso é útil para depurar falhas que não são visíveis apenas pelos metadados, como erros ocultos nos corpos de resposta.

Quando você habilita a captura de carga AJAX, o agente do browser adiciona os seguintes atributos aos eventos AjaxRequest:

• requestBody: a carga da solicitação.
• requestHeaders: cabeçalhos de solicitação como JSON.
• requestQuery: parâmetros de consulta de URL como JSON.
• responseBody: a carga da resposta.
• responseHeaders: cabeçalhos de resposta como JSON.
• ajaxRequest.id: identificador único para cada requisição AJAX.

Todos os atributos de dados da carga são truncados em 4096 bytes. Quando ocorre o truncamento, os últimos 4 bytes são substituídos por ... para indicar que o conteúdo foi cortado.

Habilitar captura de carga

Você pode habilitar a captura de carga usando um dos seguintes métodos:

window.NREUM.init = {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
}

import { BrowserAgent } from '@newrelic/browser-agent/loaders/browser-agent'

const options = {
  init: {
    ...<other init properties>...,
    ajax: {
      deny_list: ["bam.nr-data.net"],
      capture_payloads: 'failures' // or 'none', 'all'
    }
  },
  info: { ... },
  loader_config: { ... }
}

new BrowserAgent(options)

Quando você habilita a captura de carga pela primeira vez, a New Relic adiciona automaticamente regras de ofuscação de baseline para proteger dados confidenciais comuns:

• Números de cartão de crédito: detecta e mascara os principais formatos de cartão de crédito (Visa, MasterCard, American Express, Discover, etc.)
• Números de Seguro Social: detecta e mascara padrões de SSN

Você pode configurar regras de ofuscação na plataforma New Relic para mascarar dados confidenciais antes que sejam enviados para a New Relic. Para obter mais detalhes sobre regras de ofuscação, consulte Ofuscar dados do agente do browser.

Após habilitar a configuração de captura de carga, você pode visualizar os dados de carga capturados nas seguintes páginas:

• Detalhes da solicitação AJAX
• Visualização de página
• Session Replay

Como a captura de carga interage com a lista de negação

A captura de carga respeita sua lista de negação existente. Para qualquer requisição AJAX:

• Se o URL estiver na lista de negação, o evento é totalmente descartado e não são capturados metadados ou carga.
• Se o URL não estiver na lista de negação, com base nas suas configurações de captura de carga, o agente captura a carga de solicitação e resposta e aplica regra de ofuscação antes de enviar os dados para a New Relic.

Documentação relacionada