Browser agent release notesRSS

v1.323.0

View this release on GitHub → for the full technical changelog and build size information.

Features

Harvest SR on switch from ERROR to FULL mode

Update agent to handle session replays the same way as session traces, and trigger a replay harvest when SR is switching from error to full mode.

Add internal adoption metrics for AJAX Payloads

Adds an internal metric measuring adoption of AJAX payload tracking for quality assurance and improvement purposes.

Bug fixes

fix(ajax): correct DT header timestamp to server time

Distributed tracing headers (traceparent/tracestate/newrelic) generated for AJAX requests now use the New Relic server-corrected timestamp when the agent's TimeKeeper has completed its RUM-based clock correction, rather than the browser's raw local clock value. This timestamp only affects the transport duration value a receiving backend APM agent computes for its own span -- it has no effect on any other browser telemetry.

Ensure timeKeeper readiness on Connector race condition

The new Connector in RUM v2 is patched to ready the TimeKeeper, critical to agent timestamp adjustments, under a minority-case race condition branch. This is behind the feature flag and should have no impact to any user right now.

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.

The following features are currently in limited preview and will not receive standard support:

• Micro frontend (MFE) monitoring via the register() API
• BrowserPerformance "resource" type events

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.323.0 of the Browser agent was built for and tested against these browsers and version ranges: Chrome 143-153, Edge 142-152, Safari 18-27, and Firefox 145-155. For mobile devices, v1.323.0 was built and tested for Android OS 16 and iOS Safari 18-26.2.

v1.322.0

특징

SPV 이벤트를 위한 옵저버 API를 포함합니다.

에이전트 로더 실행 전에 발생한 securitypolicyviolation 이벤트를 포착하려면 ReportingObserver API를 사용하십시오. 실제로는 기존 구성과 버그가 Firefox 및 Safari 수집에 영향을 미치므로, 이는 주로 크로미움 브라우저에 영향을 미칩니다.

MFE 매니페스트

마이크로 프론트엔드가 자체적으로 알려진 자산(스크립트, 스타일시트, 이미지, 글꼴)을 선언할 수 있도록 register() API에 선택적 manifest을(를) 추가하여, 에이전트가 오류, 로그, AJAX 호출, WebSocket 및 리소스 타이밍 이벤트를 해당 마이크로 프론트엔드에 정확하게 귀속시킬 수 있도록 합니다 ― register()을(를) 호출한 스크립트가 아닌 다른 스크립트에서 로드한 자산에 대해서도 마찬가지입니다. 또한 옵트인 timingMethod을(를) 사용하면 매니페스트가 선언된 자산 전체에서 MicroFrontEndTiming 가져오기/실행 기간을 확대할 수 있습니다.

등록 유효성 검사 경고 추가

등록 API에 제공된 타겟에서 명백한 문제가 감지되면 로컬 디버깅 경고를 발생시킵니다.

버그 수정

리스너 누수를 막기 위해 web-vitals를 4.2.4에서 6.2.1로 업그레이드하십시오.

번들로 제공되는 web-vitals 라이브러리를 4.2.4에서 6.2.1로 업그레이드하여 무제한 document visibilitychange 리스너 누수를 수정했습니다: web-vitals 4.x는 모든 INP 보고 주기마다 영구 리스너를 등록하므로 수명이 긴 페이지에는 수백 개의 리스너가 누적됩니다. 또한 에이전트가 내보내는 속성 이름의 변경 없이, 에이전트가 노출되는 v5/v6 기여도 API 변경 사항(LCPAttribution.element → target 이름 변경 및 새롭게 선택 사항이 된 INP/CLS 기여도 필드)을 수용했습니다.

지지 성명

뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 이전 릴리스는 지원 종료 시점부터 더 이상 지원되지 않습니다. 출시일은 에이전트 버전의 원래 출판일을 반영합니다.

다음 기능은 현재 제한된 프리뷰로 제공되며 표준 지원을 받지 않습니다:

• register() API 를통한 마이크로 프런트엔드(MFE) 모니터링
• BrowserPerformance "resource" 유형 이벤트

새로운 브라우저 에이전트 릴리스는 일정 기간 동안 작은 단계로 고객에게 출시됩니다. 이로 인해, 귀하의 계정에서 해당 릴리스에 접근할 수 있는 날짜가 원래 게시 날짜와 일치하지 않을 수 있습니다. 자세한 내용은 이 상태 대시보드를 참조하세요.

당사의 브라우저 지원 정책에 따라, 브라우저 에이전트 v1.322.0은 다음 브라우저 및 버전 범위에 맞게 빌드되고 테스트되었습니다: Chrome 142～152, Edge 141～151, Safari 18～27 및 Firefox 144～154. 모바일 기기의 경우, v1.322.0은 안드로이드 OS 16 및 iOS Safari 18～26.2에 맞게 빌드되고 테스트되었습니다.

v1.321.0

특징

MicroFrontEndTiming 속성 변경

MicroFrontEndTiming 이벤트 속성 변경

추가 사항:

• registerUrl: MFE가 등록된 시점의 URL
• deregisterUrl: MFE가 등록 취소되거나 페이지가 언로드된 시점의 URL
• vitals.fcp.value: MFE DOM 트리에 연결되어 감지된 최초 콘텐츠풀 페인트의 값
• vitals.lcp.value: MFE DOM 트리에 연결되어 감지된 최대 콘텐츠 풀 페인트의 값입니다.
• vitals.cls.value: MFE DOM 트리에 연결되어 감지된 누적 레이아웃 이동의 값
• vitals.inp.value: MFE DOM 트리에 연결되어 감지된 다음 페인트에 대한 상호작용의 값

제거:

• 페이지 URL
• 현재 URL

탭 간의 경합을 추적하기 위한 계측 추가

업데이트된 세션 상태로 다른 페이지가 동시에 실행될 때 발생하는 경쟁 조건을 추적하기 위해 지원 가능성 메트릭을 추가합니다.

v2 타겟 표준화 개선

부작용 기반의 정의되지 않은 타겟 가정에 의존하는 대신, v2 MFE 경로 데이터를 처리하는 동안 컨테이너 에이전트 타겟에 대한 명시적인 참조를 제공하도록 에이전트 내부를 개선합니다.

v2 PageView 도입 및 연결 서비스 호출 분리

앱 설정 검색과 PageView 생성 모두를 담당하던 기존 RUM 요청이 이제 분할되었습니다(기능 플래그 하에 임시로 적용됨). 이를 통해 에이전트는 문제가 있는 연결 주기나 실패한 설정 검색에 대해 더 강력한 복원력을 갖게 되며, PageView 이벤트는 더 이상 다른 이벤트의 수집을 차단하는 종속성이 되지 않습니다.

버그 수정

세션 리플레이의 사용자 지정 마스커가 입력이 아닌 요소에도 적용되도록 보장합니다.

사용자 지정 마스커 함수가 특정 요소 유형에 적용되지 않던 문제를 수정했습니다. 사용자 지정 마스커는 nr-umask CSS 클래스 또는 data-nr-unmask 데이터 속성 중 하나가 지정된 요소에 적용되어, 마스킹될 노드를 재정의하고 해당 텍스트 내용을 노출할 수 있도록 합니다.

지지 성명

뉴렐릭은 에이전트를 정기적으로 업그레이드하여 최신 기능과 성능 이점을 얻을 것을 권장합니다. 이전 릴리스는 지원 종료 시점부터 더 이상 지원되지 않습니다. 출시일은 에이전트 버전의 원래 출판일을 반영합니다.

새로운 브라우저 에이전트 릴리스는 일정 기간 동안 작은 단계로 고객에게 출시됩니다. 이로 인해, 귀하의 계정에서 해당 릴리스에 접근할 수 있는 날짜가 원래 게시 날짜와 일치하지 않을 수 있습니다. 자세한 내용은 이 상태 대시보드를 참조하세요.

당사의 브라우저 지원 정책에 따라, 브라우저 에이전트 v1.321.0은 다음 브라우저 및 버전 범위에 대해 빌드되고 테스트되었습니다: Chrome 141～151, Edge 141～151, Safari 18～27 및 Firefox 143～153. 모바일 디바이스의 경우, v1.321.0은 안드로이드 OS 16 및 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.