Configurar eventos AjaxRequest

En la versión 1211 del agente o superior, todos los requests de red realizados por una página se registran como eventos AjaxRequest. Puede configurar qué requests se registran y qué datos se capturan:

• Lista de denegación: filtre qué dominios y URL se excluyen del seguimiento de AJAX
• Captura de carga: registre los datos completos de la solicitud y la respuesta para depurar fallos

Lista de denegación

De forma predeterminada, registramos eventos AjaxRequest para todas las solicitudes de red realizadas por su aplicación.

• Para dejar de registrar todos los eventos, agregue un único carácter comodín * (asterisco).
  • Ejemplo: *
• Para dejar de registrar eventos para un sitio completo, agregue el nombre de dominio.
  • Ejemplo: mywebsite.com
• Para dejar de registrar eventos para una página específica, agregue el dominio y la ruta.
  • Ejemplo: mywebsite.com/photos
• A partir de la versión 1.307.0 del agente, en cualquier lugar donde encontremos un * (asterisco), coincidirá con cualquier longitud de cadena.
  • Ejemplo: mywebsite.com/shop/* (para una ruta), *.mywebsite.com (para un subdominio), mywebsite.com/*/shop/*/checkout (para cadenas de URL intermedias).

La lista de denegación ignora el protocolo, el puerto, la búsqueda y el hash de una URL.

Accede a la lista de denegados

Para actualizar la lista de URL denegadas que su aplicación filtrará para la creación de eventos, vaya a la página de configuración de la aplicación:

1. Vaya a one.newrelic.com > All capabilities > Browser > (select an app) > Settings > Application settings.
2. En la sección AJAX data capture settings, en el campo Deny list, agregue los filtros que desea aplicar a la aplicación.
3. Seleccione Save para actualizar la configuración del agente.
4. Vuelva a implementar el agente del navegador (ya sea reiniciando el agente APMasociado o actualizando la instalación de copiar y pegar del navegador).

Validar filtros de la lista de denegación

Para validar si los filtros que ha agregado funcionan como se esperaba, ejecute una consulta NRQL para AjaxRequest evento que coincida con su filtro.

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

Datos de captura de carga

Puede habilitar la captura de carga para todos los requests o solo para los requests fallidos. Cuando está habilitado, el agente del browser captura las cargas de requests y respuestas para todas las llamadas AJAX de todos los dominios permitidos. Esto es útil para depurar fallas que no son visibles solo desde los metadatos, como errores ocultos en los cuerpos de respuesta.

Cuando habilita la captura de carga de AJAX, el agente del browser agrega los siguientes atributos a los eventos AjaxRequest:

• requestBody: la carga de la solicitud.
• requestHeaders: encabezados de solicitud como JSON.
• requestQuery: parámetros de consulta de URL como JSON.
• responseBody: la carga de la respuesta.
• responseHeaders: los encabezados de respuesta como JSON.
• ajaxRequest.id: identificador único para cada request AJAX.

Todos los atributos de datos de carga se truncan a 4096 bytes. Cuando se produce el truncamiento, los últimos 4 bytes se reemplazan con ... para indicar que el contenido se cortó.

Habilitar captura de carga

Puede habilitar la captura de carga utilizando uno de los siguientes 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)

Cuando habilita la captura de carga por primera vez, New Relic agrega automáticamente reglas de ofuscación de línea de base para proteger los datos confidenciales comunes:

• Números de tarjetas de crédito: detecta y enmascara los principales formatos de tarjetas de crédito (Visa, MasterCard, American Express, Discover, etc.)
• Números de Seguro Social: detecta y enmascara los patrones de SSN

Puede configurar reglas de ofuscación en la plataforma de New Relic para enmascarar datos confidenciales antes de que se envíen a New Relic. Para obtener más detalles sobre las reglas de ofuscación, consulte Ofuscar los datos del agente del browser.

Después de habilitar la configuración de captura de carga, puede ver los datos de carga capturados en las siguientes páginas:

• Detalles de solicitud AJAX
• Visualización de página
• Session Replay

Cómo interactúa la captura de carga con la lista de denegación

La captura de carga respeta su lista de denegación existente. Para cualquier solicitud AJAX:

• Si la URL está en la lista de denegación, el evento se descarta por completo y no se capturan metadatos ni carga.
• Si la URL no está en la lista de denegación, según su configuración de captura de carga, el agente captura las cargas de solicitud y respuesta y aplica reglas de ofuscación antes de enviar los datos a New Relic.

Documentación relacionada