ヘルプ APM .NETエージェントを用いたAPMインサイト カスタムロガーによる例外追跡
カスタムロガーによる例外追跡
APMインサイト.NETエージェントではサードパーティロガーとして、log4net、NLog、Serilogなどを使用して、アプリケーションごとに記録された例外を追跡します。アプリケーションで使用されているユーザー独自のアプリケーションロガーによって記録された例外も追跡できるようになりました。これを行うには次の手順を行ってください。
設定手順：
- APMインサイト.NETエージェントをインストールします。
- パス「C:\ProgramData\DotNetAgent」に移動します。
- XMLコンフィグファイル「custom_logger_instrumentation.xml」をテキストエディターで開きます。
- 次の構文ごとにパラメーターを入力します。
<site24x7 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<loggers>
<loggerMatcher className="Namespace.ClassName" methodName="MethodName" paramCount="Number_of_Parameters" severity="severity_level" paramIndex="Position_of_parameter_in_method" />
</loggers>
</site24x7>
<loggers>
<loggerMatcher className="Namespace.ClassName" methodName="MethodName" paramCount="Number_of_Parameters" severity="severity_level" paramIndex="Position_of_parameter_in_method" />
</loggers>
</site24x7>
| 属性名 | 説明 |
| className | ネームスペースをもつロガークラスのフルネームです。 |
| methodName | 例外オブジェクトを記録するロガーメソッドです。 |
| paramCount | メソッドのオーバーロードがある場合に区別するためにロガーメソッドに渡されるパラメーターの数です |
| severity | "fatal"または"warning"といった例外の重大度です。デフォルトは"fatal"です。 |
| paramIndex | メソッドパラメーター内の例外オブジェクトのインデックス値です。例として、最初のパラメーターの場合にこの値は0となります。 |
- ロガー設定を行った後、ファイルを保存してアプリケーションを再起動してください。
- トランザクションを引き起こし、アプリケーションに記録された例外をエージェントが取得します。
例：
入力：
<site24x7 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<loggers>
<loggerMatcher className="MyApplication.ExceptionLogger" methodName="Error" paramCount="1" severity="fatal" paramIndex="0" />
</loggers>
</site24x7>
<loggerMatcher className="MyApplication.ExceptionLogger" methodName="Error" paramCount="1" severity="fatal" paramIndex="0" />
</loggers>
</site24x7>
出力：
