エラー検出の補完

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

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

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

  1. コントローラ UI の [Error Detection] 構成タブで、エラー構成パネルの [] をクリックします。
  2. カスタムロガー定義の概要名を入力し、設定を使用してカスタムロガーのクラス名とメソッドを特定します。Splunk AppDynamics UI を使用してクラスとメソッドを識別する方法の詳細については、「No Content found for /db/organizations/splunk/repositories/appdsaas-25_7_0/content/documents/AppDynamics/Data_Collectors_485263423.ditamap」を参照してください。
  3. [メソッドパラメータ]フィールドに、メソッドの署名の各パラメータのパラメータ定義を追加します。メソッドがオーバーロードされている場合は、エラーを検出するオーバーロードされたメソッドの各形式に対してロガー定義を作成します。カスタムメソッドは、少なくとも1つのパラメータを受け入れる必要があり、そのパラメータはログに記録されたエラーまたは例外情報を伝えるものである必要があります。
  4. [] フィールドには、例外オブジェクトが含まれているメソッド署名のパラメータをインデックス番号（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 Transactions] オプション。このオプションを使用して、次のイベントを特定のビジネストランザクションに関連付けることができます。
  • カスタムロガー
  • 例外、メッセージ、およびロガーを無視する
  • HTTP リターンコードとリダイレクトページ
注: 選択した設定のみがビジネストランザクションに適用されます。他のすべてのアプリケーションレベルの設定は、ビジネストランザクションに適用されません。