• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

NoticeError(.NET 에이전트 API)

과부하

오류를 확인하고 선택적 사용자 정의 속성과 함께 New Relic에 보고합니다.

NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception);
NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception, IDictionary<TKey, TValue> $attributes);
NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes);
NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes, bool $is_expected);

요구 사항

이 API 호출은 다음과 호환됩니다.

  • 모든 에이전트 버전
  • 모든 앱 유형

설명

오류를 확인하고 선택적 사용자 지정 속성과 함께 New Relic에 보고합니다. 각 트랜잭션에 대해 에이전트는 NoticeError() 에 대한 첫 번째 호출의 예외 및 속성만 유지합니다. 실제 예외를 전달하거나 문자열을 전달하여 임의의 오류 메시지를 캡처할 수 있습니다.

이 메서드가 트랜잭션 내에서 호출되면 에이전트는 상위 트랜잭션 내에서 예외를 보고합니다. 트랜잭션 외부에서 호출되는 경우 에이전트는 오류 추적 을 생성하고 New Relic UI의 오류를 NewRelic.Api.Agent.NoticeError API 호출로 분류합니다. 트랜잭션 외부에서 호출되는 경우 NoticeError() 호출은 애플리케이션의 오류율에 기여하지 않습니다.

에이전트는 추적된 오류에만 속성을 추가합니다. New Relic으로 보내지 않습니다. 자세한 내용은 AddCustomAttribute() 을(를) 참조하세요.

이 API로 보고된 오류는 에이전트 구성에서 무시하도록 구성된 HTTP 상태 코드(예: 404 )를 초래하는 트랜잭션 내에서 보고될 때 여전히 New Relic으로 전송됩니다. 자세한 내용 은 APM의 오류 관리 에 대한 설명서를 참조하십시오.

이 호출을 사용하는 방법의 예를 보려면 아래 섹션을 검토하세요.

알림 오류(예외)

NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception)

매개변수

설명

$exception

예외

필수의. 계측하려는 Exception . 스택 추적의 처음 10,000자만 유지됩니다.

NoticeError(예외, 사전)

NewRelic.Api.Agent.NewRelic.NoticeError(Exception $exception, IDictionary<TKey, TValue> $attributes)

매개변수

설명

$exception

예외

필수의. 계측하려는 Exception . 스택 추적의 처음 10,000자만 유지됩니다.

$attributes

IDictionary<TKey, TValue>

오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. TKey 은 문자열이어야 하며 TValue 은 문자열 또는 객체일 수 있습니다.

NoticeError(문자열, 사전)

NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes)

매개변수

설명

$error_message

필수의. 예외인 것처럼 New Relic에 보고할 문자열을 지정합니다. 이 메서드는 오류 이벤트오류 추적 을 모두 만듭니다. 처음 1023자만 오류 이벤트에 유지되는 반면 오류 추적은 전체 메시지를 유지합니다.

$attributes

IDictionary<TKey, TValue>

필수(null일 수 있음). 오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. TKey 은 문자열이어야 하고, TValue 은 문자열 또는 객체일 수 있으며, 속성을 전송하지 않으려면 null 를 전달합니다.

NoticeError(문자열, IDictionary, bool)

NewRelic.Api.Agent.NewRelic.NoticeError(string $error_message, IDictionary<TKey, TValue> $attributes, bool $is_expected)

매개변수

설명

$error_message

필수의. 예외인 것처럼 New Relic에 보고할 문자열을 지정합니다. 이 메서드는 오류 이벤트오류 추적 을 모두 만듭니다. 처음 1023자만 오류 이벤트에 유지되는 반면 오류 추적은 전체 메시지를 유지합니다.

$attributes

IDictionary<TKey, TValue>

필수(null일 수 있음). 오류 메시지에 주석을 달기 위해 속성의 키/값 쌍을 지정하십시오. TKey 은 문자열이어야 하고, TValue 은 문자열 또는 객체일 수 있으며, 속성을 전송하지 않으려면 null 를 전달합니다.

$is_expected

부울

Apdex 점수 및 오류율에 영향을 미치지 않도록 오류를 예상대로 표시합니다.

사용자 정의 속성 없이 예외 전달

try
{
string ImNotABool = "43";
bool.Parse(ImNotABool);
}
catch (Exception ex)
{
NewRelic.Api.Agent.NewRelic.NoticeError(ex);
}

사용자 정의 속성으로 예외 전달

try
{
string ImNotABool = "43";
bool.Parse(ImNotABool);
}
catch (Exception ex)
{
var errorAttributes = new Dictionary<string, string>() {{"foo", "bar"},{"baz", "luhr"}};
NewRelic.Api.Agent.NewRelic.NoticeError(ex, errorAttributes);
}

사용자 정의 속성이 있는 오류 메시지 문자열 전달

try
{
string ImNotABool = "43";
bool.Parse(ImNotABool);
}
catch (Exception ex)
{
var errorAttributes = new Dictionary<string, string>{{"foo", "bar"},{"baz", "luhr"}};
NewRelic.Api.Agent.NewRelic.NoticeError("String error message", errorAttributes);
}

사용자 정의 속성 없이 오류 메시지 문자열 전달

try
{
string ImNotABool = "43";
bool.Parse(ImNotABool);
}
catch (Exception ex)
{
NewRelic.Api.Agent.NewRelic.NoticeError("String error message", null);
}

오류 메시지 문자열을 전달하고 예상대로 표시하십시오.

try
{
string ImNotABool = "43";
bool.Parse(ImNotABool);
}
catch (Exception ex)
{
NewRelic.Api.Agent.NewRelic.NoticeError("String error message", null, true);
}
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.