setErrorHandler

통사론

newrelic.setErrorHandler(function $callback)

브라우저 에이전트가 캡처하는 알려진 오류를 선택적으로 무시하고 그룹화할 수 있습니다.

요구 사항

• Browser Pro 또는 Pro+SPA 에이전트(v974 이상)

  • 오류 그룹화 기능을 위해서는 v1.230.0 이상이 필요합니다.

• npm을 사용하여 브라우저 에이전트를 설치하는 경우 BrowserAgent 클래스를 인스턴스화할 때 jserrors 기능을 활성화해야 합니다. features 배열에 다음을 추가합니다.

  import { JSErrors } from '@newrelic/browser-agent/features/jserrors';
  
  const options = {
    info: { ... },
    loader_config: { ... },
    init: { ... },
    features: [
      JSErrors
    ]
  }

  카피

  자세한 내용은 npm 브라우저 설치 설명서를 참조하세요.

설명

newrelic.setErrorHandler() API 호출을 사용하면 브라우저 에이전트가 캡처하는 알려진 오류를 선택적으로 무시할 수 있습니다. 브라우저 에이전트가 캡처하는 각 오류에 대해 호출되는 단일 오류 처리기 함수가 필요합니다. 핸들러가 true 을 반환하면 New Relic은 오류를 기록하지 않습니다 . 그렇지 않으면 오류가 정상적으로 처리됩니다.

또한 이후 버전의 에이전트는 사용자 지정 제공 레이블을 사용하여 예외의 핑거프린팅 또는 그룹화를 지원합니다. 이렇게 하려면 group 속성이 원하는 문자열로 설정된 부울 대신 객체를 반환합니다. 빈 문자열 또는 이 정확한 사양을 준수하지 않는 개체를 제공하는 것은 오류가 무시되는 true 사례와 동일하게 취급된다는 점을 아는 것이 중요합니다. 이 동작은 이전 버전과 호환됩니다.

매개변수

예

기본 오류 처리기 기능 사용

브라우저 에이전트가 캡처하는 특정 오류를 무시하려면 콜백 함수 내부에 오류 개체를 포함합니다.

newrelic.setErrorHandler(function(err) {
  if (shouldIgnoreError(err)) {
    return true;
  } else {
    return false;
  }
});

핸들러 기능의 지문 오류

오류 받은 편지함 UI에서 볼 수 있도록 특정 오류에 사용자 지정 레이블을 할당합니다.

newrelic.setErrorHandler(function(err) {
  if (isReferenceError(err)) {
    return { group: 'My reference errors' }; // error is included and tagged under this label
  } else if (isSomeSpecificError(err)) {
    return { group: '' }; // error will be excluded!
    // return { Group: 'still excluded - prop name has capital G!' };
  } else {
    return false; // error is included without any label
  }
})