콘텐츠로 이동

버전 정보

2026/08/11

RUM SDK 3.3.7 추가 및 개선:

  1. 선택적 WebGL/WebGL2 Session Replay 플러그인 추가, NPM 및 CDN 방식 지원, 드로잉 드라이브를 통해 예산 제약을 받는 픽셀 스냅샷으로 게임 및 시각적 화면을 기록합니다. WebGL 구현은 RUM 메인 패키지와 분리되어 있어, WebGL을 사용하지 않는 애플리케이션은 플러그인을 가져올 필요가 없습니다. Canvas 녹화 사용 설명서
  2. allowTraceHeaderWithoutSession 구성 추가. 활성화하면 현재 RUM Session이 샘플링에 포함되지 않더라도 allowedTracingUrls와 일치하는 XHR 및 Fetch 요청에 Trace Header를 주입할 수 있습니다. 이로 인해 Session이 생성되거나 강제로 활성화되지 않으며, 해당 미샘플링 Session의 RUM 데이터도 업로드되지 않습니다. Web 애플리케이션 접속
  3. Canvas 2D 자동 녹화 및 command capture 최적화, 추가적인 드로잉 API 및 상태 보완; 부분 또는 투명도 변경 누락, 비동기 프레임 순서 오류, 확대/축소 시 스냅샷 덮어쓰기 불완전 및 reset과 bitmap이 개별 전송되어 발생하는 깜빡임 수정. 다중 Canvas는 공정한 스케줄링, 변경 탐지 및 유계 동시성을 사용하여 동적 화면의 연속성과 페이지 성능을 모두 고려합니다. Canvas 녹화 사용 설명서
  4. 대형 DOM, 동적 Shadow DOM 및 스타일시트 리플레이 최적화, 대형 스냅샷과 급격한 DOM 변경 시 분할, 원자적 커밋 및 베이스라인 복원을 사용하여 노드 이동이 "삭제 후 추가"로 분할되어 발생하는 페이지 흔들림 및 대형 요소나 CSS 스타일 누락을 줄입니다. Session Replay 접속 설명
  5. 압축 업로드 및 Session Replay 전송 신뢰성 강화: 압축 Worker가 비정상일 때 자동으로 비압축 업로드로 대체하여 View, Action, Error, Resource 등 RUM 데이터 손실 방지; 동시에 인코딩 백프레셔, 네트워크 재시도 및 페이지 종료 시 Replay 베이스라인과 후속 세그먼트 순서를 유지하여 불완전 또는 누락된 리플레이를 줄입니다.
  6. Hash Router View URL의 쿼리 파라미터 해석 수정, #/path?key=value의 파라미터가 이제 View URL Query에 올바르게 기록됩니다. RUM 데이터 구조

업그레이드 참고: WebGL Replay는 SDK 3.3.7부터 제공되며, RUM 메인 패키지 버전 >= 3.3.7이 필요하며, 플러그인과 메인 패키지가 동일한 SDK 릴리스 버전을 사용하는 것이 좋습니다. 플러그인은 Canvas auto 모드에서만 작동하며, 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의 문자열 프리셋은 품질, 샘플링 및 스케줄링 예산을 동시에 조정하며, 숫자 값은 인코딩 품질만 조정합니다.

2026/07/29

RUM SDK 3.3.6 추가:

  1. React, Vue, Angular, Next.js 및 Nuxt 프레임워크 플러그인, 라우트 템플릿 기반 View 수집 지원, 해당 프레임워크의 오류 진입점 제공. 접속 설명
  2. Next.js App Router, Pages Router 및 Nuxt 3/4의 클라이언트 통합. SSR 접속 설명
  3. 실험적 네이티브 WebSocket 장기 연결 수집, 연결 통계를 RUM Resource로 집계. WebSocket 장기 연결 수집
  4. startView()에서 url을 통한 View URL 지정 지원, 수동 View와 프레임워크 Router 통합에 사용. 사용자 정의 View
  5. startSession() 추가, 현재 Session 즉시 종료 및 세션 샘플링 재실행 지원, 런타임에 sessionSampleRate를 덮어쓸 수 있음. 샘플링 및 런타임 Session 제어

2026/04/17

Canvas Session Replay 녹화 추가. 참조 Resource Hook 기능 추가. 참조

2025/04/23

remoteConfiguration 추가, 원격으로 데이터 수집 구성을 동적으로 변경할 수 있는 기능 지원.

2025/04/13

  1. shouldMaskNode 구성 추가, session replay 노드 마스킹 효과를 사용자 정의
  2. sessionOnErrorSampleRate 구성 추가, 오류 세션 이벤트만 수집하도록 구현. 참조
  3. sessionReplayOnErrorSampleRate 구성 추가. 오류 관련 Session Replay 데이터만 수집하도록 구현 참조

2022/9/29

초기화 파라미터에 isIntakeUrl 구성 추가, 요청 리소스 URL에 따라 해당 리소스 데이터 수집 여부를 판단하는 데 사용. 기본적으로 모두 수집.

2022/3/10

  1. traceType 구성 추가, 분산 추적 도구 유형 지정. 구성하지 않으면 기본값은 ddtrace. 현재 6가지 유형 지원: ddtrace, zipkin, skywalking_v3, jaeger, zipkin_single_header, w3c_traceparent.

  2. allowedTracingOrigins 추가, Trace 수집기에 필요한 헤더를 주입할 모든 요청 목록. 요청의 origin 또는 정규식일 수 있음.

  3. 기존 구성 항목 allowedDDTracingOrigins와 신규 구성 항목 allowedTracingOrigins는 동일한 기능 구성에 속함. 둘 중 하나를 선택하여 구성할 수 있으며, 둘 다 구성한 경우 allowedTracingOrigins의 가중치가 allowedDDTracingOrigins보다 높음.

2021/5/20

  1. V2 버전 메트릭 데이터 변경에 대응하여 DataKit 1.1.7-rc0 이후 버전으로 업그레이드 필요. 자세한 내용은 DataKit 구성을 참조.

  2. SDK V2 버전 업그레이드, CDN 주소가 https://static.guance.com/browser-sdk/v2/dataflux-rum.js로 변경됨.

  3. rum_web_page_performance, rum_web_resource_performance, js_error, page 메트릭 데이터 수집 제거, view, action, long_task, error 메트릭 데이터 수집 추가.

  4. 초기화 시 trackInteractions 구성 추가, Action(사용자 행동 데이터) 수집 활성화에 사용. 기본값은 비활성화 상태.

문서 평가

이 페이지가 도움이 되었나요?