변경 로그¶
Browser SDK 3.3.25¶
2026-11-20
- Web RUM 전체 버전과 슬림 버전에 초기화 콜백
onInitSuccess및onInitError가 추가되었습니다.remoteConfiguration을 활성화하면 애플리케이션에서 원격 응답이 처리되었는지, 로컬 구성으로 폴백했는지, SDK 초기화에 실패했는지 구분할 수 있습니다. 중복 시작 및 압축 Worker 상태 격리 문제도 수정했습니다. 자세한 내용은 SDK 초기화 결과 가져오기를 참고하십시오. - Fetch 리소스 이벤트는 브라우저가 제공하는 Resource Timing을 우선 사용합니다. SDK는 애플리케이션의 응답 본문을 읽거나 복제하지 않고 소요 시간과 바이트 수를 수집합니다. 각 타이밍 항목은 최대 한 요청에만 연결됩니다. 자세한 내용은 Fetch 리소스 소요 시간을 참고하십시오.
- 폼이 변경된 뒤에도 이전 기본값, 선택 항목 또는 편집 가능한 텍스트가 세션 리플레이에 남을 수 있는 문제를 수정했습니다. 리플레이와 리소스 이벤트의 URL에 동일한 개인정보 보호 규칙을 적용하고 분산 추적의 요청 매칭 조건을 강화했습니다.
- 페이지 이탈, 네트워크 재연결 및 업로드 지연 시 배치 전송 순서를 수정했습니다. 자체
toJSON이 있는 확장 불가 객체를 포함한 이벤트도 원래 속성 설명자를 보존하면서 전송할 수 있습니다. - DOM만 기록하는 리플레이 번들을 추가했습니다. 이벤트 인코딩, URL 분석 및 리플레이 압축을 최적화하고 Canvas 유휴 작업과 Worker 메모리 사용량을 줄였습니다.
- 다른 창에 속한 요소의 클릭 수집을 수정했습니다. Angular 라우터 재초기화, 시작 단계의 오류 버퍼링, 라우트 쿼리 매개변수의 개인정보 보호 처리를 개선했습니다.
2026/09/16¶
Browser SDK 3.3.16 추가 및 개선 사항:
- 전체 RUM 패키지와 슬림 RUM 패키지는 WebView에서 앱의 Visitor ID 재사용을 지원합니다.
visitorId.enabled가 활성화되어 있고, 현재 도메인이 네이티브 브리지 허용 목록 검증을 통과하며, 앱이 동기식FTWebViewJavascriptBridge.getVisitorid()인터페이스를 제공하고 유효한 식별자를 반환하는 경우, 규칙과 일치하는 XHR 및 Fetch 요청 헤더와 RUMcontext.visitor_id는 해당 식별자를 우선 사용합니다. 브리지를 사용할 수 없거나 반환 값이 유효하지 않거나 읽기에 실패하면 기존 Web 식별자로 폴백합니다. 네이티브 식별자의 유효 기간과 로테이션은 앱에서 관리하며, 유효한 네이티브 식별자를 읽는 경우 WebresetVisitorId()는 별도로 ID를 교체하지 않습니다. 이 기능을 사용하려면 해당 인터페이스를 지원하는 모바일 SDK가 함께 제공되어야 합니다. - 첫 번째 View의 보고 시점을 최적화했습니다. 초기 페이지 및 각 라우팅 전환 시 생성되는 View는 처음으로 샘플링 및 전송 조건을 충족하는 즉시 보고가 예약되며, 배치 전송 간격을 기다릴 필요가 없습니다. 후속 업데이트는 기존 주기에 따라 병합하여 보고합니다. 페이지가 숨겨지거나 종료될 때 각 View의 최신 상태를 유지하며, 압축 업로드 및 압축 실패 시 폴백을 지원하여 짧은 시간의 방문과 빠른 페이지 전환 시 View 손실을 줄입니다.
- 강제 Session과 오류 보상 샘플링 간의 상호 작용을 수정했습니다.
setForcedSession()또는startSessionReplayRecording({ force: true })를 호출한 후에는 현재 Session의 RUM 데이터와 이미 시작된 Replay를 오류를 기다리지 않고 보고할 수 있으며, 기존 오류 Replay 버퍼를 해제합니다. 또한 탭 간 Session 전환, 지연 만료 시의 재개 생성 경계, 강제 Session 종료 후 새 Session의 오류 표시 및 보상 보고를 수정했습니다.setForcedSession()자체는 Replay 녹화를 시작하지 않으며, 이후 Session은 구성된 샘플링 규칙을 계속 따릅니다. - 일부 JavaScript 오류에 오류 메시지만 있고 위치 정보가 누락되는 문제를 수정했습니다.
Error.stack에서 스택 프레임을 파싱할 수 없을 때 브라우저가window.onerror를 통해 제공하는 스크립트 주소, 줄 번호 및 사용 가능한 열 번호를 유지하여 스크립트 구문 오류 등의 시나리오를 처리합니다. 기존 스택은 변경되지 않으며, 브라우저가 제공하지 않은 위치 정보는 임의로 생성하지 않습니다. - Session Replay에서 대형 스타일시트가 누락될 수 있는 문제를 수정했습니다. DOM과 CSS의 합계가 전체 스냅샷 용량 제한을 초과하지 않는 경우, 큰 외부 CSS 링크 및 인라인 CSS를 유지하여 개별 스타일시트의 규칙 수, 문자 수, 처리 시간 제한 또는 일반 문자열 길이 제한으로 인한 Replay 스타일 누락을 줄입니다. 개인정보 처리와 전체 용량 보호는 그대로 유지하며, 스타일시트를 읽을 수 없거나 용량을 초과하면 기존 폴백 로직을 사용합니다.
- Core, 전체 RUM, 슬림 RUM 및 Logs의 공개 TypeScript 선언을 런타임 API와 일치하도록 수정했습니다. 전체 및 슬림 RUM 패키지는
TraceType을 직접 가져올 수 있으며,traceType은 지원되는 문자열 값을 허용합니다. 이전 구성 별칭, 공용 타입 내보내기, Logs의'all'전달 구성 및 로그 레벨 메서드 선언을 보완하여 기존의 유효한 사용법에서 발생하는 타입 오류를 줄였습니다. - JSON 보고 요청의
Content-Type을application/json;charset=UTF-8로 수정했으며, 압축 업로드 시나리오도 함께 처리합니다. - SDK 저장소에 성능 평가 보고서와 CDN 및 npm 연동 각각을 위한 성능 자체 점검 가이드를 추가하고
performance/디렉터리에 통합 수록하여 SDK가 페이지 성능에 미치는 영향을 평가하기 쉽도록 했습니다.
2026/09/07¶
RUM SDK 3.3.15 추가 및 개선 사항:
visitorId구성을 추가하여 규칙과 일치하는 XHR 및 Fetch에 안정적인 익명 방문자 식별자를 주입하고, RUMcontext.visitor_id에 해당 값을 연결합니다. 동일 Origin 문자열 접두사, 정규식 및 함수 매칭을 지원하며, TTL, 스토리지 폴백 및resetVisitorId()로테이션도 지원합니다. Session 또는 분산 추적 샘플링에 의존하지 않습니다. 방문자 식별자 Visitor ID- Visitor ID는 Fetch 매개변수와 XHR 동기 콜백의 요청 의미를 보존하며, 일치하지 않는 요청은 기존 사용자 지정 헤더를 유지합니다. 동일 타임스탬프 로테이션은 이전 폴백 ID를 복원하지 않으며, 리소스 연관 헤더를 점유하지 못하도록 하고, View/이벤트 컨텍스트가 SDK 식별자를 덮어쓰지 않도록 합니다.
- iframe 간
Request의 비즈니스 요청 헤더 보존, XHR 동기 실패 후 재시도 시 식별자 중복, 네이티브WeakSet이 없을 때의 Visitor ID 초기화 호환성 문제를 수정했습니다. 초기화 전에 버퍼링된 이벤트의 식별자를 보완하고, RUM 공통 컨텍스트를 읽을 때마다 전역 필드를 반복해서 깊은 복사하지 않도록 했습니다.
2026/08/31¶
RUM SDK 3.3.14 추가 및 개선 사항:
enablePrivacyForActionName구성을 추가했으며 기본값은 비활성화입니다. 활성화하면 자동 Action 이름이 DOM 개인정보 보호 수준을 따릅니다. 마스킹된 콘텐츠는 고정 자리표시자 이름을 사용하고, 비공개 양식 필드는 텍스트나 표준 명명 속성을 노출하지 않으며, 숨겨진 하위 트리의 클릭은 자동 Action을 생성하지 않습니다. 명시적으로 지정한 비즈니스 이름은 숨겨지지 않은 노드에서 계속 사용할 수 있습니다. 사용자 작업 Action
2026/08/28¶
RUM SDK 후속 버전 추가 및 개선 사항:
- 브라우저가 User-Agent Client Hints를 제공하는 경우
platformVersion을 통해 Windows 10과 Windows 11을 구분하고, 첫 번째 RUM 데이터 배치가 동일한 시스템 버전 정보를 사용하도록 보장합니다. 이 기능을 지원하지 않거나 고엔트로피 값 반환을 거부하거나 조회가 시간 초과되면 기존 User-Agent를 계속 사용합니다. RUM 데이터 구조
2026/08/26¶
RUM SDK 3.3.11 추가 및 개선 사항:
- Wujie(无界) 등의 마이크로프런트엔드에서 Session Replay가 iframe 간 JavaScript realm 요소를 인식하는 문제를 수정했습니다. iframe realm에서 생성되어 현재 페이지의 open ShadowRoot에 마운트된 네이티브 양식 입력, DOM 변경 및 이미 활성화된 Canvas 녹화가 이제 정상적으로 Replay에 포함됩니다. 양식 요소의
value,checked,selectedIndex속성 할당도 기록할 수 있습니다. Canvas 명령 수집 모드에서는 realm 간 Canvas가 자동으로 비트맵 스냅샷을 폴백으로 사용합니다. 이 기능은 iframe 내부 문서나 closed Shadow DOM은 포함하지 않습니다. Session Replay 연동 안내
RUM SDK 3.3.10 추가 및 개선 사항:
- 자동 Action은 open Shadow DOM 내부의 클릭 요소를 지원하며, iframe의 JavaScript realm에서 생성된 후 ShadowRoot에 마운트된 요소(예: Wujie 마이크로프런트엔드)도 포함합니다. SDK는 실제 클릭 대상에 따라 이름과 Shadow 경계를 포함한 위치 정보를 생성하고, 테이블 행, 카드 등 컨테이너의 집계된 텍스트를 Action 이름으로 잘못 사용하지 않도록 합니다. Closed Shadow DOM은 여전히 브라우저의 캡슐화 경계 제한을 받습니다. 사용자 작업 Action
2026/08/25¶
RUM SDK 3.3.9 추가 및 개선 사항:
- SPA
route_changeView는 Chrome Soft Navigation API를 지원합니다. 브라우저가 기본적으로 지원하는 경우 라우팅 전환 시 FCP, LCP, LCP 요소 선택자 및view_navigation_type이 추가될 수 있습니다. 기본 API를 지원하지 않는 경우에는 Navigation API, History API 또는 Hash 라우팅 호환 로직을 통해 계속 Route View를 생성하고push,replace,traverse탐색 유형을 유지하지만, 해당 라우팅의 FCP/LCP는 보완하지 않습니다. RUM 데이터 구조 - 페이지가 지속적으로 업데이트되는 동안 View 데이터가 늦게 보고될 수 있는 문제를 수정하여, 전송 대기 중인 View가 업데이트될 때 원래 배치의 보고 기한을 계속 사용하고 기존 전송 간격에 따라 최신 데이터를 보고하도록 했습니다.
2026/08/20¶
RUM SDK 3.3.8 추가 및 개선 사항:
- WebSocket Resource에 세그먼트 종료 페이지 경로 필드
resource_websocket_end_view_path를 추가했습니다. 세그먼트 시작 경로는 표준 필드view_path를 재사용하며, Resource 탐색기에서 연결 시작 또는 종료 페이지를 기준으로 필터링할 수 있습니다. WebSocket 지속 연결 수집
2026/08/11¶
RUM SDK 3.3.7 추가 및 개선 사항:
- 선택적 WebGL/WebGL2 Session Replay 플러그인을 추가했으며 NPM 및 CDN 연동을 지원합니다. 그리기 기반의 예산 제약이 있는 픽셀 스냅샷을 통해 게임 및 시각화 화면을 기록합니다. WebGL 구현은 RUM 메인 패키지와 분리되어 있어 WebGL을 사용하지 않는 앱은 플러그인을 포함할 필요가 없습니다. Canvas 녹화 사용 설명서
allowTraceHeaderWithoutSession구성을 추가했습니다. 활성화하면 현재 RUM Session이 샘플링되지 않았더라도allowedTracingUrls와 일치하는 XHR 및 Fetch 요청에 Trace Header를 주입할 수 있습니다. 이로 인해 Session이 생성되거나 강제 활성화되지 않으며, 해당 미샘플링 Session의 RUM 데이터도 보고되지 않습니다. Web 애플리케이션 연동- Canvas 2D 자동 녹화 및 command capture를 최적화하고 더 많은 그리기 API와 상태를 보완했습니다. 부분 변경 또는 투명도 변경 누락 수집, 비동기 프레임 순서 뒤바뀜, 확대/축소 스냅샷 커버리지 불완전, reset과 bitmap을 별도로 전송하여 발생하는 깜박임을 수정했습니다. 다중 Canvas는 공정 스케줄링, 변경 감지 및 제한된 동시성을 사용하여 동적 화면의 연속성과 페이지 성능을 함께 고려합니다. Canvas 녹화 사용 설명서
- 대형 DOM, 동적 Shadow DOM 및 스타일시트 Replay를 최적화했습니다. 대형 스냅샷과 갑작스러운 DOM 변경에는 분할, 원자적 커밋 및 기준선 복구를 적용하여 노드 이동이 '먼저 삭제 후 추가'로 분할되면서 발생하는 페이지 흔들림과 대형 요소 또는 CSS 스타일 누락을 줄입니다. Session Replay 연동 안내
- 압축 업로드와 Session Replay 전송 안정성을 강화했습니다. 압축 Worker에 예외가 발생하면 자동으로 비압축 업로드로 폴백하여 View, Action, Error, Resource 등의 RUM 데이터 손실을 방지합니다. 또한 인코딩 백프레셔, 네트워크 재시도 및 페이지 종료 시 Replay 기준선과 후속 세그먼트 순서를 유지하여 불완전하거나 누락된 Replay를 줄입니다.
- Hash Router View URL의 쿼리 매개변수 파싱을 수정하여
#/path?key=value의 매개변수가 이제 View URL Query에 올바르게 기록됩니다. RUM 데이터 구조
업그레이드 안내: WebGL Replay는 SDK
3.3.7부터 제공되며 RUM 메인 패키지 버전>= 3.3.7이 필요합니다. 플러그인과 메인 패키지는 동일한 SDK 릴리스 버전을 사용할 것을 권장합니다. 플러그인은 Canvasauto모드에서만 작동하며,init()시 등록되어야 하고 WebGL 엔진 초기화보다 먼저 실행되어야 합니다. GL 명령 재생, 프레임 단위 비디오 또는OffscreenCanvas녹화는 제공하지 않습니다.Canvas 2D에서 명명된 품질 프리셋을 사용하지 않는 경우 자동 수집 interval/cooldown의 기본값이
1000/1000 ms에서250/250 ms로 조정되었습니다.low,medium,high프리셋도 더 빠른 Canvas 2D 스케줄링을 사용합니다. 동적 화면은 더 매끄럽게 이어지지만 CPU, 인코딩 및 업로드 오버헤드가 증가할 수 있습니다. WebGL에서 interval/cooldown을 명시적으로 구성하지 않은 경우에는 더 보수적인 GPU 리드백 주기를 유지합니다.
replayCanvasSampling의 양수 값은 snapshot 경로를 선택하는 데 사용되며 수집 빈도를 의미하지 않습니다. 빈도는 interval, cooldown 및 backoff로 제어됩니다.replayCanvasQuality의 문자열 프리셋은 품질, sampling 및 스케줄링 예산을 동시에 조정하며, 숫자 값은 인코딩 품질만 조정합니다.
2026/07/29¶
RUM SDK 3.3.6 추가:
- React, Vue, Angular, Next.js 및 Nuxt 프레임워크 플러그인을 추가하여 라우트 템플릿 기반으로 View를 수집하고 해당 프레임워크 오류 진입점을 제공합니다. 연동 안내
- Next.js App Router, Pages Router 및 Nuxt 3/4의 클라이언트 통합. SSR 연동 안내
- 실험적인 네이티브 WebSocket 지속 연결 수집으로, 연결 통계를 RUM Resource로 집계합니다. WebSocket 지속 연결 수집
startView()는url을 통해 View URL을 지정할 수 있으며, 수동 View와 프레임워크 Router 통합에 사용됩니다. 사용자 지정 ViewstartSession()을 추가하여 현재 Session을 즉시 종료하고 세션 샘플링을 다시 실행할 수 있으며, 런타임에sessionSampleRate를 재정의할 수 있습니다. 샘플링 및 런타임 Session 제어
2026/06/30¶
RUM SDK 3.3.3 추가:
- 슬림 버전 RUM SDK를 추가했으며 NPM 및 CDN 연동을 지원합니다. View, Resource, Long Task, Error, Action, Context, 사용자 지정 이벤트 및 분산 추적 등 일반적인 RUM 기능을 유지하지만 Session Replay, Canvas 녹화 및
compressIntakeRequests보고 압축은 포함하지 않습니다. 슬림 버전 RUM SDK 연동 안내
2025/04/23¶
remoteConfiguration을 추가하여 원격에서 데이터 수집 구성을 동적으로 수정할 수 있습니다.
2025/04/13¶
shouldMaskNode구성을 추가하여 Session Replay 노드 마스킹 효과를 사용자 지정할 수 있습니다.sessionOnErrorSampleRate구성을 추가하여 오류 세션 이벤트만 수집할 수 있습니다. 참고sessionReplayOnErrorSampleRate구성을 추가했습니다. 오류와 관련된 Session Replay 데이터만 수집할 수 있습니다. 참고
2022/9/29¶
초기화 매개변수에 isIntakeUrl 구성을 추가했습니다. 요청 리소스 URL에 따라 해당 리소스 데이터를 수집해야 하는지 판단하는 데 사용하며, 기본값은 모두 수집입니다.
2022/3/10¶
-
분산 추적 도구 유형을 구성하는
traceType을 추가했습니다. 구성하지 않으면 기본값은ddtrace입니다. 현재 6가지 데이터 유형을 지원합니다:ddtrace,zipkin,skywalking_v3,jaeger,zipkin_single_header,w3c_traceparent. -
allowedTracingOrigins를 추가했습니다. Trace 수집기에 필요한 header를 주입할 수 있는 모든 요청 목록입니다. 요청의 origin일 수도 있고 정규식일 수도 있습니다. -
기존 구성 항목
allowedDDTracingOrigins와 새 구성 항목allowedTracingOrigins는 동일한 기능 구성에 속합니다. 둘 중 하나만 구성할 수 있으며, 둘 다 구성하면allowedTracingOrigins의 우선순위가allowedDDTracingOrigins보다 높습니다.
2021/5/20¶
-
V2 버전 메트릭 데이터 변경에 맞춰 DataKit 1.1.7-rc0 이후 버전으로 업그레이드해야 합니다. 자세한 내용은 DataKit 구성을 참고하십시오.
-
SDK가 V2 버전으로 업그레이드되었으며 CDN 주소가
https://static.guance.com/browser-sdk/v2/dataflux-rum.js로 변경되었습니다. -
rum_web_page_performance,rum_web_resource_performance,js_error,page메트릭 데이터 수집을 제거하고view,action,long_task,error메트릭 데이터 수집을 추가했습니다. -
초기화 시
trackInteractions구성을 추가하여 Action(사용자 행동 데이터) 수집을 활성화하는 데 사용하며, 기본값은 비활성화 상태입니다.