Browser agent release notesRSS

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

Recurso

Detectar e relatar cargas AJAX

Introduz o suporte à captura de carga AJAX para chamadas de API XMLHttpRequest e Fetch. Quando ativado, o agente do browser capturará os corpos, cabeçalhos e parâmetros de consulta de request/resposta, com detecção e análise automáticas de operações do GraphQL. A captura de carga é configurável para monitorar todos os requests ou apenas falhas, com limites de tamanho integrados (4 KB por atributo) e suporte a ofuscação para proteção de dados confidenciais.

Novos atributos de AjaxRequest

Captura de Carga - O agente do browser agora pode capturar e relatar cargas de solicitação e resposta para chamadas AJAX, fornecendo insights mais profundos sobre a atividade de rede e interações de API.

Configuração: ative a captura de carga usando a opção de configuração ajax.capture_payloads:

• 'all' - Capturar cargas para todos os requests AJAX
• 'failures' - Capturar apenas requests com falha (erros de HTTP, erros de rede ou erros do GraphQL)
• none - Desativar a captura de carga (padrão)

Novos atributos em eventos AjaxRequest: quando as cargas AJAX são capturadas, novos atributos são incluídos automaticamente em eventos AjaxRequest:

• requestQuery - Parâmetros de consulta de URL
• requestHeaders, responseHeaders - cabeçalhos HTTP
• requestBody, responseBody - Cargas de solicitação e resposta (apenas formatos baseados em texto: JSON, XML, GraphQL, texto simples)

Detecção de GraphQL: quando erros do GraphQL são detectados, um novo atributo adicional é incluído automaticamente nos eventos de AjaxRequest:

• operationHasErrors - Indica se a operação retornou erros

Todos os dados capturados são automaticamente truncados para 4KB por atributo e suportam padrões de ofuscação para informações confidenciais.

Melhorar a ofuscação para oferecer suporte ao filtro de evento

O comportamento de ofuscação agora pode ser configurado para ser aplicado apenas a um subconjunto de tipos de evento, usando a propriedade eventFilter, que suporta uma matriz de strings de tipo de evento por regra de ofuscação. Quando fornecida, a regra de ofuscação será aplicada apenas quando o tipo de evento corresponder a um dos itens na matriz eventFilter. Para compatibilidade com versões anteriores, não fornecer uma propriedade eventFilter nas regras de configuração aplicará a regra a todos os dados.

Correções de bugs

Calcular browser_stack_hash a partir do stack trace truncado

Calcular o hash da stack do browser a partir do stack trace truncado em vez do stack trace não truncado. Antes dessa alteração, as coletas de primeira ocorrência de eventos JSE podiam ter um hash de stack do browser diferente de coletas futuras do mesmo stack trace se ele fosse truncado. Isso melhorará o agrupamento de erros de eventos JavaScriptError.

Obter responseBodySize do corpo se content-length estiver ausente

Resolve um problema em que os eventos de AjaxRequest relatavam incorretamente um responseSize de 0 ou undefined devido à falta de mecanismos de fallback e verificações falsas excessivamente restritivas. Introduziu um mecanismo de fallback que calcula os tamanhos de resposta a partir de cargas capturadas para requests Fetch e XHR quando o cabeçalho content-length está ausente.

Correção do tratamento de imagens embutidas para o Session Replay

Corrige um problema em que o Session Replay pode deixar uma imagem quebrada no DOM ativo. Nesta versão, a versão subjacente do rrweb evitará manipular a imagem ativa no DOM.

Declaração de apoio

New Relic recomenda que você atualize o agente regularmente para garantir que esteja obtendo os benefícios mais recentes de recursos e desempenho. Versões mais antigas não terão mais suporte quando chegarem ao fim de sua vida útil. As datas de lançamento refletem a data de publicação original da versão do agente.

Novos lançamentos de agente do browser são disponibilizados aos clientes em pequenas etapas ao longo de um período de tempo. Por esse motivo, a data em que o lançamento fica acessível à sua conta pode não corresponder à data de publicação original. Consulte este dashboard de status para obter mais informações.

De acordo com a nossa política de suporte a navegadores, a v1.317.0 do agente de Browser foi desenvolvida para e testada nestes navegadores e intervalos de versões: Chrome 139-149, Edge 139-149, Safari 18-26 e Firefox 141-151. Para dispositivos móveis, a v1.317.0 foi compilada e testada para Android OS 16 e iOS Safari 18-26.2.

v1.316.0

Features

Use app-namespaced keys for session

The browser agent now namespaces the session info to per browser app, using the combination of licenseKey and applicationID provided at startup. This means different apps sharing the same origin and browser localStorage will no longer share the same session, which was an accepted but not ideal collision, causing feature modes to bleed from one over to another for the duration of a session previously.

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.316.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 136-146, Edge 136-146, Safari 18-26, and Firefox 138-148. For mobile devices, v1.316.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.315.0

Features

Enhance SPA API to support targetPageLoad option

Allow the SPA API to target and work on the initialPageLoad type BrowserInteraction event. A new option is added to .interaction that now binds the returned handle to the initial page load interaction at any point in time.

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.315.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 136-146, Edge 136-146, Safari 18-26, and Firefox 138-148. For mobile devices, v1.315.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.314.0

Recurso

Adicionar atributo ajaxRequest.id

Adiciona um identificador exclusivo a todos os eventos AjaxRequest para facilitar consultas diretas e o detalhamento de dados nas interfaces do NR1.

Melhorar a captura do tempo de carregamento do PageViewTiming

O tempo de carregamento agora é capturado de forma mais confiável para páginas, herdando a ideia do onTTFB do web-vital. Antes, ocasionalmente perdia loadEventEnd da entrada de navegação devido a uma condição de corrida do browser, particularmente para páginas maiores/de carregamento mais longo, o que fazia com que o carregamento fosse 0.

Ajustar timestamps para distorção de relógio devido à suspensão da máquina

Alguns hardwares Linux e Apple podem congelar os relógios da API de desempenho ao entrar em suspensão profunda, o que pode causar timestamp impreciso no evento New Relic ao despertar. Isso introduz uma nova alteração que tenta corrigir a distorção de relógio causada por máquinas congeladas.

Detectar automaticamente ações do usuário do MFE

Adicionar suporte para atribuição automática de Micro Frontend (MFE) de eventos UserAction via um atributo de dados data-nr-mfe-id. Anteriormente, os eventos UserAction eram capturados apenas globalmente pelo aplicativo de navegador do contêiner. Com essa mudança, o agente agora realiza uma pesquisa de cadeia parental para elementos associados à ação, identificados pelo atributo data-nr-mfe-id.

Para associar eventos UserAction a um MFE registrado, adicione um data-nr-mfe-id no nó DOM raiz controlado pelo seu pacote MFE que corresponda ao ID fornecido à API register.

Permitir que o Session Replay tente novamente as cargas

As cargas que falharam com códigos de nova tentativa serão coletadas novamente pelo agente. Dados adicionais do Session Replay não serão coletados até que a coleta seja repetida com sucesso.

Declaração de apoio

New Relic recomenda que você atualize o agente regularmente para garantir que esteja obtendo os benefícios mais recentes de recursos e desempenho. Versões mais antigas não terão mais suporte quando chegarem ao fim de sua vida útil. As datas de lançamento refletem a data de publicação original da versão do agente.

Novos lançamentos de agente do browser são disponibilizados aos clientes em pequenas etapas ao longo de um período de tempo. Por esse motivo, a data em que o lançamento fica acessível à sua conta pode não corresponder à data de publicação original. Consulte este dashboard de status para obter mais informações.

De acordo com a nossa política de suporte a navegadores, a v1.314.0 do agente do Browser foi desenvolvida para e testada nestes navegadores e intervalos de versões: Chrome 136–146, Edge 136–146, Safari 18–26 e Firefox 138–148. Para dispositivos móveis, a v1.314.0 foi compilada e testada para Android OS 16 e iOS Safari 18–26.2.