エラー検出の補完

Java および .NET では、Splunk AppDynamics が一般的なエラー処理フレームワークのエラーメソッドと見なすメソッドを、カスタムロガーを定義することで独自にカスタム定義するエラーメソッドを使用して補完することができます。アプリケーションがビジネストランザクションでこのメソッドを呼び出すと、Splunk AppDynamics はメトリックのためにトランザクションをエラートランザクションと見なします。

カスタムロガー構成では、メソッドに渡される例外またはエラー情報を含むパラメータを指定できます。この情報は Splunk AppDynamics のエラーメッセージとして表示されます。パラメータで を呼び出してメッセージが抽出されます。

カスタムロガーを構成するには、次の手順を実行します。

  1. コントローラ UI の [Error Detection] 設定タブで、エラー設定パネルの [Add Custom Logger Definition] をクリックします。
  2. カスタムロガー定義の概要名を入力し、設定を使用してカスタムロガーのクラス名とメソッドを特定します。Splunk AppDynamics UI を使用してクラスとメソッドを識別する方法の詳細については、「Data_Collectors_485263423」を参照してください。
  3. [Method Parameter] フィールドで、メソッドの署名の各パラメータにパラメータ定義を追加します。メソッドがオーバーロードしている場合は、エラーを検出するオーバーロードしたメソッドの形式ごとにロガー定義を作成してください。カスタムメソッドは、少なくとも1つのパラメータを受け入れる必要があり、そのパラメータはログに記録されたエラーまたは例外情報を伝えるものである必要があります。
  4. [Exception Parameter] フィールドには、例外オブジェクトが含まれているメソッド署名のパラメータをインデックス番号（0 ベース）で指定します。インデックスによって識別されるこのパラメータは、配列を含む任意のタイプのオブジェクトにできます。オブジェクトが null でない場合、Splunk AppDynamics はこのオブジェクトを文字列に変換します。これによりエラー詳細を生成します。ビジネストランザクションは、null 以外の例外オブジェクトがロガーメソッドに渡された場合にのみエラーと見なされます。

.NETアプリケーションにおける以下のカスタムロガークラスとメソッドについて考えてみましょう。

エラーメソッドがオーバーロードしていることに注目してください。ログに記録するエラーとして最初のパラメータを使用し、メソッドの 2 番目の形式で記録されたエラーをキャプチャします。次のスクリーンショットは、この設定を示しています。

例外パラメータが 0 に設定されているため、文字列メッセージが識別されます。

Java の場合、既存の検出/無視設定を選択して有効にできます

.NETアプリケーションにおける以下のカスタムロガークラスとメソッドについて考えてみましょう。ログに記録するエラーとして最初のパラメータを使用し、メソッドの 2 番目の形式で記録されたエラーをキャプチャします。次のスクリーンショットは、この設定を示しています。例外パラメータが 0 に設定されているため、文字列メッセージが識別されます。Java と .NET の場合、既存の検出/無視設定を選択して有効にできます

  • 名前空間とクラス = Logging.MyLogger
  • logger.Error(string message, int param1)
  • logger.Error(string message, int param1, int param2)
Configure Business Transaction オプションが表示されます。このオプションを使用して、次のイベントを特定のビジネストランザクションに関連付けることができます。
  • カスタムロガー
  • 例外、メッセージ、およびロガーを無視する
  • HTTP リターンコードとリダイレクトページ
注: 選択した設定のみがビジネストランザクションに適用されます。他のすべてのアプリケーションレベルの設定は、ビジネストランザクションに適用されません。