Datadog Browser RUM에서 예기치 않은 동작이 발생하는 경우, 이 가이드를 사용하여 문제를 신속하게 해결하세요. 계속 문제가 발생하면 Datadog 지원에 문의하여 추가 지원을 받으시기 바랍니다. 각 릴리스에는 개선 사항과 수정 사항이 포함되어 있으므로 정기적으로 최신 버전의 [RUM Browser SDK2로 업데이트하세요.

누락된 데이터

RUM 데이터가 보이지 않거나 일부 사용자에 대한 데이터가 누락된 경우

콘텐츠 보안 정책 가이드라인을 읽고 웹사이트에서 RUM Browser SDK CDN 및 인테이크 엔드포인트에 대한 액세스 권한을 허용하는지 확인하세요.

RUM Browser SDK를 초기화합니다

브라우저 콘솔에서 window.DD_RUM.getInternalContext()를 실행하여 RUM Browser SDK가 초기화되었는지 확인하고 application_id, session_id 및 보기 개체가 반환되는지 확인합니다:

RUM Browser SDK가 설치되어 있지 않거나 성공적으로 초기화되지 않은 경우 아래와 같은 ReferenceError: DD_RUM is not defined 오류가 표시될 수 있습니다:

브라우저 개발자 도구 콘솔 또는 네트워크 탭에서 RUM Browser SDK 로딩과 관련된 오류를 확인할 수도 있습니다.

참고: 정확한 결과를 얻으려면 sessionSampleRate를 100으로 설정하세요. 자세한 내용은 브라우저 RUM 및 브라우저 RUM & 세션 리플레이 샘플링을 위한 설정 구성을 참조하세요.

Datadog 인테이크에 대한 데이터

RUM Browser SDK는 주기적으로 데이터 배치를 Datadog 인테이크에 전송합니다. 데이터가 전송되는 경우 브라우저 개발자 도구의 네트워크 섹션에 네트워크 요청 타겟팅 /v1/input(URL 원본 부분은 RUM 구성에 따라 다를 수 있음)이 표시되어야 합니다:

RUM 쿠키

RUM Browser SDK는 쿠키를 사용하여 세션 정보를 저장하고 여러 페이지에서 사용자 세션을 추적합니다. 쿠키는 자사 쿠키(도메인에 설정됨)이며 사이트 간 추적에 사용되지 않습니다. 다음은 RUM Browser SDK가 설정하는 쿠키입니다:

참고: _dd_l, _dd_r 및 _dd 쿠키가 최신 버전의 RUM Browser SDK에서 _dd_s로 대체되었습니다.

기술적인 제한 사항

RUM Browser SDK가 전송하는 각 이벤트는 다음과 같이 빌드됩니다:

• RUM 글로벌 컨텍스트
• 이벤트 컨텍스트 (존재하는 경우)
• 이벤트와 관련된 속성

예시:

window.DD_RUM && window.DD_RUM.setGlobalContextProperty('global', {'foo': 'bar'})
window.DD_RUM && window.DD_RUM.addAction('hello', {'action': 'qux'})

예제 코드는 다음과 같은 액션 이벤트를 생성합니다:

{
  "type": "action",
  "context": {
    "global": {
      "foo": "bar"
    },
    "action": "qux"
  },
  "action": {
    "id": "xxx",
    "target": {
      "name": "hello"
    },
    "type": "custom"
  },
  ...
}

이벤트 또는 요청이 다음 제한 사항 중 하나를 초과하는 경우, Datadog 인테이크에 의해 거부됩니다.

고객 데이터가 권장 3KiB를 초과하는 경우 경고

RUM browser SDK를 사용하면 글로벌 컨텍스트, 사용자 정보 및 기능 플래그를 설정한 다음 수집된 이벤트에 포함할 수 있습니다.

사용자 대역폭에 미치는 영향을 최소화하기 위해, RUM Browser SDK는 Datadog 인테이크에 전송되는 데이터를 스로틀링합니다. 그러나 대량의 데이터를 전송하면 인터넷 연결 속도가 느린 사용자의 성능에 여전히 영향을 미칠 수 있습니다.

최상의 사용자 경험을 위해 Datadog은 글로벌 컨텍스트, 사용자 정보 및 기능 플래그의 크기를 3KiB 미만으로 유지할 것을 권장합니다. 데이터가 이 제한을 초과하면 경고가 표시됩니다: The data exceeds the recommended 3KiB threshold.

크로스 오리진 읽기 차단 경고

Chromium 기반 브라우저에서, RUM Browser SDK가 데이터를 Datadog 인테이크에 전송할 때 콘솔에 CORB 경고가 인쇄됩니다: Cross-Origin Read Blocking (CORB) blocked cross-origin response.

이 경고는 인테이크가 비어 있지 않은 JSON 객체를 반환하기 때문에 표시됩니다. 이 동작은 보고된 Chromium 문제입니다. RUM Browser SDK에는 영향을 미치지 않으며 안전하게 무시해도 됩니다.

참고 자료

추가 유용한 문서, 링크 및 기사:

실제 사용자 모니터링(RUM)블로그 콘텐츠 보안 정책설명서