Browser agent release notesRSS

v1.322.0

Característica

Incluir la API de observador para eventos de SPV

Utilice la API ReportingObserver para capturar securitypolicyviolation eventos que ocurrieron antes de la ejecución del cargador del agente. En la práctica, esto afecta principalmente a los navegadores Chromium, ya que las configuraciones y los errores existentes afectan la recopilación de Firefox y Safari.

Manifiesto de MFE

Agrega un manifest opcional a la API register() para que un Micro Frontend pueda declarar sus propios activos conocidos (scripts, hojas de estilo, imágenes, fuentes), lo que permite al agente atribuirle con precisión errores, logs, llamadas AJAX, WebSockets y eventos de temporización de recursos —incluso para los activos cargados por un script distinto al que llamó a register(). Un timingMethod opcional también permite que un manifiesto amplíe las ventanas de obtención/ejecución de MicroFrontEndTiming en todos sus activos declarados.

Agregar advertencias de validación de registro

Emite advertencias de depuración local si se detectan problemas obvios desde los objetivos proporcionados a la API de registro.

Corrección de errores

Actualizar web-vitals de 4.2.4 a 6.2.1 para solucionar una fuga de listeners

Se actualizó la biblioteca web-vitals incluida de 4.2.4 a 6.2.1, lo que solucionó una fuga ilimitada de listeners document visibilitychange: web-vitals 4.x registra un listener permanente en cada ciclo de informes de INP, por lo que las páginas de larga duración acumulan cientos de listeners. También se absorbieron los cambios de la API de atribución de v5/v6 a los que está expuesto el agente (el cambio de nombre de LCPAttribution.element → target y los campos de atribución de INP/CLS recientemente opcionales) sin cambios en los nombres de los atributos que emite el agente.

Declaración de apoyo

New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil. Las fechas de lanzamiento reflejan la fecha de publicación original de la versión del agente.

Las siguientes características se encuentran actualmente en versión preliminar limitada y no recibirán soporte estándar:

• Monitoreo de micro frontend (MFE) mediante la API register()
• Eventos de tipo BrowserPerformance “resource”

Las nuevas versiones del agente del browser se lanzan a los clientes en pequeñas etapas a lo largo de un periodo de tiempo. Debido a esto, la fecha en que el lanzamiento esté disponible en su cuenta puede no coincidir con la fecha de publicación original. Consulte este dashboard de estado para obtener más información.

De acuerdo con nuestra política de soporte de navegadores, la versión 1.322.0 del agente del browser se construyó y probó con los siguientes navegadores y rangos de versiones: Chrome 142-152, Edge 141-151, Safari 18-27 y Firefox 144-154. Para dispositivos móviles, la v1.322.0 se compiló y probó para Android OS 16 e iOS Safari 18-26.2.

v1.321.0

Features

MicroFrontEndTiming attributes changes

MicroFrontEndTiming event attribute changes

Additions:

• registerUrl: The URL at the time the MFE was registered
• deregisterUrl: The URL at the time the MFE was deregistered or the page unloaded
• vitals.fcp.value: The value of the first contentful paint detected tied to the MFE DOM tree
• vitals.lcp.value: The value of the largest contentful paint detected tied to the MFE DOM tree
• vitals.cls.value: The value of the cumulative layout shift detected tied to the MFE DOM tree
• vitals.inp.value: The value of the interaction to next paint detected tied to the MFE DOM tree

Removals:

• pageUrl
• currentUrl

Add instrumentation to track races between tabs

Adds a supportability metric to track a race condition that occurs when another page runs at the same time with an updated session state.

improve v2 target standardization

Improves agent internals to provide an explicit reference for container agent targets while processing v2 MFE pathway data, rather than relying on side-effect driven undefined target assumptions.

Introduce v2 PageView & decouple connect service call

The old RUM request responsible for both retrieving app configurations and PageView generation is now split (temporarily under a feature flag). This makes the agent more resilient on problematic connect cycles or unsuccessful config retrieval, and the PageView event would no longer be the dependency blocking other events from harvesting.

Bug fixes

Ensure Session Replay's custom masker applies to non-inputs

Fixed an issue where the custom masker function was not applying to certain element types. The custom masker is applied to elements that are decorated with one of nr-umask CSS class or data-nr-unmask data attribute, allowing a node that would otherwise be masked to be overridden and its text contents exposed.

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach end-of-life. Release dates are reflective of the original publish date of the agent version.

New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this status dashboard for more information.

Consistent with our browser support policy, v1.321.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 141-151, Edge 141-151, Safari 18-27, and Firefox 143-153. For mobile devices, v1.321.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.320.1

Bug fixes

Avoid obfuscating keys and reserved system vals

Preserves all keys as well as reserved system values for AjaxRequest and Page View Timing events.

Apply hard cap to MFE FCP

Fixes an issue where MFE vitals could occasionally report out of bounds FCP/LCP values (e.g. after a browser tab freeze or suspend) instead of being dropped like other stale data.

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach end-of-life. Release dates are reflective of the original publish date of the agent version.

New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this status dashboard for more information.

Consistent with our browser support policy, v1.320.1 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 140-150, Edge 140-150, Safari 18-27, and Firefox 142-152. For mobile devices, v1.320.1 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.320.0

Features

Improve ability to apply reasonable caps to MFE vitals

Fixed a bug in the Register API's micro-frontend (MFE) vitals tracking where a script's timing correlation could be reused after it went stale, causing First Contentful Paint (and other vitals) to be misreported as up to several seconds slower than they actually were for MFEs that remount without their underlying script reloading (e.g. in single-page applications).

MFE iframe support - Beta Access

Adds an interface for capturing MFE data encapsulated in an iFrame. This is experimental, is subject to change or total removal and should not be used in a production environment until GA status has been reached

Bug fixes

Deduplicate auto-instrumented MFE events

Fixes duplicate reporting of auto-instrumented events (AJAX requests, JS errors, console logs, WebSocket activity etc.) when a micro-frontend is registered with the register() API multiple times. Previously, a single auto-instrumented event originating from a repeatedly-registered MFE script would be reported once per registration — Auto-detected events are now collapsed to a single report per real occurrence when they resolve to the same underlying script and the same registered MFE id. Explicit API-driven calls (.addPageAction(), .log(), .noticeError(), etc.) and MicroFrontEndTiming events remain per-registration, as intended, and distinct MFEs that happen to share a script (e.g. two different MFEs registered from the same inline <script> block) continue to be reported independently.

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach end-of-life. Release dates are reflective of the original publish date of the agent version.

New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this status dashboard for more information.

Consistent with our browser support policy, v1.320.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 140-150, Edge 140-150, Safari 18-27, and Firefox 142-152. For mobile devices, v1.320.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.319.0

Features

MFE vitals improvements

Implement quality of life improvements on the collection of MFE vital timings.

• If no FCP value is observed within 10 seconds, shut down observers for memory saving and outlier control.
• Decorate observed DOM trees with the MFE instance ID to facilitate debugging and prevent double-instrumentation of the same DOM tree from multiple instances pointed at the same MFE target.

Automatically Detect MFE Web Sockets

Add support for automatic Micro Frontend (MFE) attribution of WebSocket events. Previously, WebSocket events were only ever automatically captured globally by the container browser application. With this change, the agent cross-compares the call stack signature of the WebSocket method to the call stack signature of the MFE module that registered with the register API. If the file that is responsible for registering with the browser agent is found in the call stack signature of the WebSocket method being triggered, that event will be attributed to the MFE instead of the container.

Do not obfuscate attribute keys

Do not obfuscate attribute keys in our addCustomAttributes method for the BEL serializer. This change affects attributes in AjaxRequest, PageViewTiming, and BrowserInteraction (soft nav only) events.

Bug fixes

Avoid capturing agent AJAX payloads

Prevent the AJAX capture_payloads feature from capturing the agent's own telemetry requests (harvests to NR beacon endpoints).

Keep Ajax payload out of unrelated events

Drops captured AJAX request + payload info from unrelated events (AJAX timeslice metrics, session trace) via a shared params object.

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach end-of-life. Release dates are reflective of the original publish date of the agent version.

New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this status dashboard for more information.

Consistent with our browser support policy, v1.319.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 139-149, Edge 139-149, Safari 18-27, and Firefox 142-152. For mobile devices, v1.319.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.318.0

Features

Add websocket init config

Adds web_sockets block to NREUM init configuration. Setting web_sockets.enabled to true turns on the web sockets feature. The web sockets feature is disabled by default.

MFE core web-vitals detection

Add internal detection methods for FCP, INP, CLS, and LCP when spawned by a MFE

Improve agent startup

Provide better support for scenarios where agent startup can be interrupted before RUM call completes successfully and feature session modes are saved into local storage (where applicable).

Support statement

New Relic recommends that you upgrade the agent regularly to ensure that you're getting the latest features and performance benefits. Older releases will no longer be supported when they reach end-of-life. Release dates are reflective of the original publish date of the agent version.

New browser agent releases are rolled out to customers in small stages over a period of time. Because of this, the date the release becomes accessible to your account may not match the original publish date. Please see this status dashboard for more information.

Consistent with our browser support policy, v1.318.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 139-149, Edge 139-149, Safari 18-26, and Firefox 141-151. For mobile devices, v1.318.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.317.0

Característica

Detectar y reportar cargas AJAX

Introduce soporte para la captura de carga AJAX para llamadas API de XMLHttpRequest y Fetch. Cuando está habilitado, el agente del browser capturará los cuerpos de request/respuesta, los encabezados y los parámetros de consulta, con detección y análisis automáticos de las operaciones de GraphQL. La captura de carga es configurable para monitorear todos los requests o solo las fallas, con límites de tamaño incorporados (4KB por atributo) y soporte de ofuscación para la protección de datos confidenciales.

Nuevos atributos de AjaxRequest

Captura de carga - el agente del browser ahora puede capturar y reportar las cargas de request y respuesta para las llamadas AJAX, lo que proporciona información valiosa más profunda sobre la actividad de la red y las interacciones de la API.

Configuración: Habilite la captura de carga usando la opción de configuración ajax.capture_payloads:

• 'all' - Capturar cargas para todos los requests AJAX
• 'failures' - Capturar solo los requests fallidos (errores HTTP, errores de red o errores de GraphQL)
• none - Deshabilitar la captura de carga (predeterminado)

Nuevos atributos en los eventos AjaxRequest: cuando se capturan las cargas de AJAX, se incluyen automáticamente nuevos atributos en los eventos AjaxRequest:

• requestQuery - Parámetros de consulta de URL
• requestHeaders, responseHeaders - Encabezados HTTP
• requestBody, responseBody - Cargas de request y respuesta (solo formatos basados en texto: JSON, XML, GraphQL, texto sin formato)

Detección de GraphQL: Cuando se detectan errores de GraphQL, se incluye automáticamente un nuevo atributo adicional en los eventos de AjaxRequest:

• operationHasErrors - Indica si la operación devolvió errores

Todos los datos capturados se truncan automáticamente a 4KB por atributo y admiten patrones de ofuscación para la información confidencial.

Mejorar la ofuscación para admitir el filtro de eventos

El comportamiento de ofuscación ahora se puede configurar para que se aplique solo a un subconjunto de tipos de eventos, usando la propiedad eventFilter, que admite una matriz de cadenas de tipos de eventos por regla de ofuscación. Cuando se proporciona, la regla de ofuscación solo se aplicará cuando el tipo de evento coincida con uno de los elementos de la matriz eventFilter. Para mantener la compatibilidad con versiones anteriores, si no se proporciona una propiedad eventFilter en las reglas de configuración, la regla se aplicará a todos los datos.

Corrección de errores

Calcular browser_stack_hash a partir del rastreo del stack truncado

Calcular el hash del stack del browser a partir del rastreo del stack truncado en lugar del rastreo del stack no truncado. Antes de este cambio, las recolecciones de primera aparición de eventos JSE podían tener un hash del stack del browser diferente de las recolecciones futuras del mismo rastreo del stack si se truncaba. Esto mejorará la agrupación de errores de los eventos JavaScriptError.

Obtener responseBodySize del cuerpo si falta content-length

Aborda un problema en el que los eventos AjaxRequest reportaban de manera inexacta un responseSize de 0 o undefined debido a la falta de mecanismos de respaldo y comprobaciones falsy demasiado restrictivas. Se introdujo un mecanismo de respaldo que calcula los tamaños de respuesta a partir de las cargas capturadas para los requests Fetch y XHR cuando falta el encabezado content-length.

Parche para el manejo de imágenes en línea para Session Replay

Soluciona un problema por el cual Session Replay podía dejar una imagen rota en el DOM en vivo. En esta versión, la versión subyacente de rrweb evitará manipular la imagen en vivo en el DOM.

Declaración de apoyo

New Relic recomienda que actualices el agente periódicamente para garantizar que obtengas las últimas características y beneficios de rendimiento. Las versiones anteriores ya no recibirán soporte cuando lleguen al final de su vida útil. Las fechas de lanzamiento reflejan la fecha de publicación original de la versión del agente.

Las nuevas versiones del agente del browser se lanzan a los clientes en pequeñas etapas a lo largo de un periodo de tiempo. Debido a esto, la fecha en que el lanzamiento esté disponible en su cuenta puede no coincidir con la fecha de publicación original. Consulte este dashboard de estado para obtener más información.

De acuerdo con nuestra política de compatibilidad de navegadores, la versión 1.317.0 del agente de Browser se creó y probó para estos navegadores y rangos de versiones: Chrome 139-149, Edge 139-149, Safari 18-26 y Firefox 141-151. Para dispositivos móviles, la v1.317.0 se compiló y probó para Android OS 16 e iOS Safari 18-26.2.