문제 해결¶

RUM SDK 초기화 성공 확인 방법¶

브라우저 콘솔을 엽니다:

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

존재:

존재하지 않음:

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

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

초기화 실패¶

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

초기화 성공했으나 데이터가 전송되지 않거나 데이터가 불완전하게 전송됨¶

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

Session Replay 재생 불가¶

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

순서대로 확인:

sessionReplaySampleRate가 0보다 큰지 확인;
SDK 초기화 후 startSessionReplayRecording()이 호출되었는지 확인;
현재 SDK 버전이 Session Replay를 지원하는지 확인;
DataKit에서 session_replay_endpoints가 활성화되었는지 확인;
공용 네트워크 DataWay를 사용하는 경우, 클라이언트가 데이터 전송 주소에 정상적으로 접근할 수 있는지 확인;
현재 Session이 샘플링 정책으로 인해 리플레이 데이터를 수집하지 않았는지 확인.

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

리플레이 데이터가 처리 프로세스에 진입했음을 의미합니다. 잠시 후 페이지를 새로고침하세요. 시간이 오래 걸리는 경우, 리플레이 데이터가 계속 전송되고 있는지 확인하세요.

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

다음과 같은 이유가 있을 수 있습니다:

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

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

먼저 페이지를 새로고침하고 다시 시도하세요. 계속 실패하면 Session 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가 성공적으로 연결되었는지 확인하는 방법¶

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