사용자 정의 Error 보고¶

Browser RUM SDK는 처리되지 않은 프론트엔드 예외를 자동으로 수집합니다. 비즈니스 코드에서 이미 캐치되었지만 여전히 모니터링이 필요한 예외의 경우 addError(error, context?)를 사용하여 능동적으로 보고합니다.

매개변수¶

NPM 예제¶

import { datafluxRum } from "@cloudcare/browser-rum"

async function submit() {
  try {
    await submitOrder()
  } catch (error) {
    datafluxRum.addError(error, {
      operation: "submit_order",
      retry_count: 1
    })
  }
}

CDN 예제¶

fetch("/api/orders").catch(function (error) {
  window.DATAFLUX_RUM &&
    window.DATAFLUX_RUM.addError(error, {
      operation: "submit_order"
    })
})

fetch("/api/orders").catch(function (error) {
  window.DATAFLUX_RUM.onReady(function () {
    window.DATAFLUX_RUM.addError(error, {
      operation: "submit_order"
    })
  })
})

주의사항¶

1. 원본 Error 객체를 우선적으로 전달하고, error.message만 전달하지 마십시오.
2. Context에 비밀번호, Token, 전체 요청 본문 등 민감한 데이터를 포함하지 마십시오.
3. 동일한 예외가 SDK에 의해 자동 수집됨과 동시에 addError()가 호출되면 두 개의 Error 데이터가 생성됩니다. 이미 처리되었거나 비즈니스에서 능동적으로 식별한 예외에 대해서만 이 API를 호출하십시오.

검증¶

예외를 트리거한 후, 해당 웹 애플리케이션의 Error 탐색기에서 operation 필드로 submit_order를 필터링하고 오류 message, stack 및 사용자 정의 Context를 확인하십시오.