• 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呼び出しは、次のものと互換性があります。

  • すべてのエージェントバージョン
  • すべてのアプリタイプ

説明

エラーに気づき、オプションのカスタム属性とともにNewRelicに報告してください。トランザクションごとに、エージェントはNoticeError()への最初の呼び出しからの例外と属性のみを保持します。実際の例外を渡すか、文字列を渡して任意のエラーメッセージをキャプチャできます。

このメソッドがトランザクション内で呼び出された場合、エージェントは親トランザクション内で例外を報告します。トランザクションの外部で呼び出された場合、エージェントはエラートレースを作成し、NewRelicUIでエラーをNewRelic.Api.Agent.NoticeError API呼び出しとして分類します。トランザクションの外部で呼び出された場合、 NoticeError()呼び出しはアプリケーションのエラー率に影響しません。

エージェントは、トレースされたエラーにのみ属性を追加します。 NewRelicには送信されません。詳細については、 AddCustomAttribute()を参照してください。

このAPIで報告されたエラーは、エージェント構成によって無視されるように構成された404などのHTTPステータスコードをもたらすトランザクション内で報告された場合でも、NewRelicに送信されます。詳細については、APMでのエラーの管理に関するドキュメントを参照してください。

この呼び出しの使用方法の例については、以下のセクションを確認してください。

NoticeError(例外)

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

パラメータ

説明

$exception

例外

必須。インストルメントするException 。スタックトレースの最初の10,000文字のみが保持されます。

NoticeError(例外、IDictionary)

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

パラメータ

説明

$exception

例外

必須。インストルメントするException 。スタックトレースの最初の10,000文字のみが保持されます。

$attributes

IDictionary <TKey、TValue>

エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。TKeyは文字列である必要があり、 TValueは文字列またはオブジェクトである可能性があります。

NoticeError(String、IDictionary)

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

パラメータ

説明

$error_message

ストリング

必須。例外であるかのようにNewRelicに報告する文字列を指定します。このメソッドは、エラーイベントエラートレースの両方を作成します。エラーイベントでは最初の1023文字のみが保持され、エラートレースではメッセージ全体が保持されます。

$attributes

IDictionary <TKey、TValue>

必須(nullの場合もあります)。エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。TKeyは文字列である必要があり、 TValueは文字列またはオブジェクトである可能性があります。属性を送信しない場合は、 nullを渡します。

NoticeError(String、IDictionary、bool)

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

パラメータ

説明

$error_message

ストリング

必須。例外であるかのようにNewRelicに報告する文字列を指定します。このメソッドは、エラーイベントエラートレースの両方を作成します。エラーイベントでは最初の1023文字のみが保持され、エラートレースではメッセージ全体が保持されます。

$attributes

IDictionary <TKey、TValue>

必須(nullの場合もあります)。エラーメッセージに注釈を付けるには、属性のキーと値のペアを指定します。TKeyは文字列である必要があり、 TValueは文字列またはオブジェクトである可能性があります。属性を送信しない場合は、 nullを渡します。

$is_expected

bool

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株式会社。

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