콘텐츠로 이동

문제 해결


RUM SDK 초기화 성공 여부 확인 방법

  1. 브라우저 콘솔을 엽니다:

  1. DATAFLUX_RUM 객체가 존재하는지 확인합니다:

존재:

존재하지 않음:

  1. DATAFLUX_RUM.getInternalContext()를 실행하여 객체가 초기화되었는지 확인합니다:

초기화에 성공하면 현재 애플리케이션 페이지에 해당하는 session, application, view 등의 객체 정보를 얻을 수 있습니다.

초기화 실패

  1. CDN 방식으로 연동한 경우, 현재 애플리케이션이 https 사이트인지 확인합니다.
  2. 설정이 올바른지 확인합니다(설정 매개변수의 형식 및 이름 포함).

초기화 성공했으나 데이터가 전송되지 않거나, 전송 데이터가 불완전한 경우

  1. 브라우저 버전 정보를 확인하고, 브라우저 지원 목록에서 해당 데이터가 지원되는지 확인합니다.
  2. RUM Browser SDK의 초기화 위치를 확인하고, 애플리케이션 코드에서 가능한 빠르게 초기화 작업을 수행하도록 조정합니다.

세션 리플레이 재생 불가

페이지에 "재생 데이터 없음" 메시지 표시

다음 항목을 순서대로 확인하세요:

  1. sessionReplaySampleRate0보다 큰지 확인합니다.
  2. SDK 초기화 후 startSessionReplayRecording()을 호출했는지 확인합니다.
  3. 현재 SDK 버전이 세션 리플레이를 지원하는지 확인합니다.
  4. DataKit에서 session_replay_endpoints가 활성화되어 있는지 확인합니다.
  5. 공용 DataWay를 사용하는 경우, 클라이언트가 데이터 전송 주소에 정상적으로 접근할 수 있는지 확인합니다.
  6. 현재 세션이 샘플링 전략으로 인해 리플레이 데이터를 수집하지 않았는지 확인합니다.

페이지에 "데이터 생성 중" 메시지 표시

리플레이 데이터가 처리 과정에 들어갔음을 의미합니다. 잠시 후 페이지를 새로고침하세요. 오랜 시간이 지나도 완료되지 않으면, 리플레이 데이터가 계속 전송되고 있는지 확인하세요.

페이지에 "리플레이 데이터 불완전" 메시지 표시

다음과 같은 원인이 있을 수 있습니다:

  • 세션이 종료되기 전에 일부 데이터가 아직 전송되지 않았습니다.
  • 사용자가 페이지 또는 애플리케이션을 종료하여 캐시된 데이터가 제때 전송되지 않았습니다.
  • 클라이언트 네트워크 이상.
  • SDK 초기화 또는 녹화 시작 시간이 너무 늦었습니다.
  • 데이터 업로드가 프록시, 방화벽 또는 브라우저 정책에 의해 차단되었습니다.

페이지에 "상태 조회 오류" 또는 "리플레이 파일 조회 오류" 메시지 표시

먼저 페이지를 새로고침하고 다시 시도하세요. 계속 실패하면 세션 ID, 애플리케이션 ID, 발생 시간 및 페이지 오류 정보를 기록하여 기술 지원에 문의하세요.

연동 및 샘플링 설정은 세션 리플레이 연동 방법을 참조하세요.

XHR/FETCH 요청이 APM 트레이스와 연결되지 않는 경우

초기화 설정에서 allowedTracingOrigins 설정이 활성화되어 있는지, 형식이 올바른지 확인합니다. (정규식으로 설정하는 경우, 배열 안에 문자열이 아닌 정규식 객체가 포함되어 있는지 확인하세요)

올바름 ```js datafluxRum.init({ applicationId: '', datakitOrigin: '', env: 'production', version: '1.0.0', trackInteractions: true, allowedTracingOrigins: [/https:\/\/.*\.my-api-domain\.com/] // 정규식에는 따옴표를 사용하지 않음 })

오류
 ```js
datafluxRum.init({
    applicationId: '<DATAFLUX_APPLICATION_ID>',
    datakitOrigin: '<DATAKIT ORIGIN>',
    env: 'production',
    version: '1.0.0',
    trackInteractions: true,
    allowedTracingOrigins: ["/https:\\/\\/.*\\.my-api-domain\\.com/"]
})

APM과 프론트엔드 XHR/FETCH 연동 성공 여부 확인 방법

  1. 브라우저 콘솔을 엽니다.
  2. XHR/FETCH 요청의 Request Headers에 해당 요청 헤더 키워드 정보가 포함되어 있는지 확인합니다. 아래 이미지는 ddtrace 관련 요청 헤더 예시입니다:

문서 평가

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