アプリケーション エージェントのノードプロパティ（B ～ C）

このプロパティを使用してバイトコード トランスフォーマー ログ（BCT ログ）を構成します。このログは、どの Splunk AppDynamics がインストゥルメント化を行い、どのクラスが JVM にロードされたかを示します。最初のファイル（0.log）はサーバー起動のコンテキストを保持するために保存され、ロールオーバーされません。それ以降のファイルはローテーションされます。ファイル名のフォーマットは、ByteCodeTransformer.<timestamp>.<N>.log. タイムスタンプは YYYY_MM_DD_HH_mm_ss の形式で表示されます。Nはゼロから増えていきます。

例

ByteCodeTransformer.2012_09_12_20_17_57.0.log

ファイルサイズは 15 秒ごとにチェックされるため、ロールオーバーされる前に、ファイルは指定されたしきい値よりも少し大きくなる可能性があります。

生成される最初のログファイルには、ByteCodeTransformer.<timestamp>.0.log という名前が付けられます。

このプロパティ値の形式は、デフォルト値 20,5,4 で示されています。番号付きセグメントの意味は次のとおりです。

• 20 は最初のログファイルのサイズ（MB）（.0 バージョン）
• 5 は後続の各ローリングファイルのサイズ（MB）
• 4 は保持する ByteCodeTransformer ログファイルの数

バイトコードの再変換を無効または有効にします。デフォルトでは、Java エージェントの Sun および JRockit バリアントは、JVM に再起動せずに、新しい POJO ルールなどのバイトコード再変換が必要な設定変更を適用します。エージェントが自動再変換を実行してこのようなルールを適用しないようにするには、bciengine-disable-retransformation を true に設定します。

true に設定すると、Glassfish AMX MBean のサポートが有効になります。Glassfish サーバーサポートの詳細については、「GlassFishスタートアップ設定」を参照してください。

このノードのコールグラフの粒度を指定します。このプロパティが使用されていると、グローバル構成は無視されます。adaptive-callgraph-granularityプロパティがtrueに設定されている場合は、この値は無視されます。デフォルト値のゼロは、[Configuration] > [Instrumentation] > [Call Graph Settings] からグローバル設定が使用されることを意味します。再起動は必要ありません。 

このプロパティは、404 エラーの原因となる URL のキャプチャを無効または有効にします。そのURLは15分ごとにERRORイベントとして報告され、イベントビューアで表示できます。JVMバージョンの再変換がサポートされていない場合、JVMを再起動する必要があります。

通常、404 エラーは、アプリケーションコードが実行されないことを意味します。その結果、スナップショット内でキャプチャされることはありません。このプロパティを true に設定することで、404 エラーに関するインサイトを得ることができます。404 エラーの原因となったすべての URL が報告されます。

capture-404-urls ノードプロパティは、Splunk AppDynamics バージョン 3.6 で廃止され、capture-error-urls に置き換えられています。

このプロパティは、次の HTTP エラーのキャプチャを有効または無効にします。

• 401 - Unauthorized
• 500 - Internal Server Error
• 404 - Page Not Found
• その他のエラーコードはすべて汎用 HTTP エラーコードバケットに配置されます。

これら4つのカテゴリについては、エージェントが毎分カテゴリあたり25個までURLを収集し、5分ごとにイベントを送信します。

Troubleshoot > Errors > Exceptions タブ > HTTP Error Codeをクリックし、エラーコードをドリルダウンするとこれらのURLが表示されます。

capture-raw-sql が有効な場合、動的パラメータ（疑問符パラメータなど）を持つ SQL コールはエージェントによりキャプチャされ、ランタイムの値にバインドされた動的パラメータとともにコントローラ UI に表示されます。 

例

たとえば、次のように SQL コールを構成する Java コードがあるとします。

stmt = new PreparedStatement("select * from user where ssn = ?")
stmt.bind(1, "123-123-1234")
stmt.execute()

capture-raw-sql を有効にすると、Splunk AppDynamics は次の形式で SQL コールをキャプチャします。

select * from user where ssn = '123-123-1234'

capture-raw-sql が無効な場合、SQL コールは疑問符パラメータ付きで表示され、値にバインドされません。

capture-raw-sql を無効にし、SQL プリペアドステートメントで疑問符パラメータを使用すると、機密データがコントローラ UI に表示されなくなります。

重要な点としては、上記のように、SQL ステートメントの元のプリペアドステートメント形式で、機密の値をパラメータ化する必要があることに注意してください。次のステートメントでは、capture-raw-sql が有効か無効かに関係なく、機密の可能性がある情報（ssn 値）が UI に表示されます。

stmt = new PreparedStatement("select * from user where ssn ='123-123-1234'")

IBM JVM を使用している環境でこのノードプロパティを変更する場合は、JVM を再起動する必要があります。この機能には特定のJDBCクラスの再変換が必要ですが、IBMエージェントではそれができないためです。

オプションをエージェントプロパティとして設定すると、ノードのSQLキャプチャモードに影響を与えます。「コールグラフ設定」で説明されている [Capture Raw SQL] オプションを使用して、すべてのノードの動作を設定できます。

webservice が setStatus() を使用してエラーを送り返している場合に、エラーをキャプチャするようにエージェントに指示します。デフォルトでは、エージェントによって sendError() のみがインストゥルメント化されます。

クラスが複数の Spring Bean 名にマッピングされると、デフォルトで最初に発見された Spring Bean 名のみが表示されます。これは誤解を招く可能性があります。これは、Web サービス B の Spring Bean を持つ Web サービス A のコールグラフを表示する時などに、誤解を招くことがあります。このプロパティを false に設定すると、これらの競合が発生した場合クラス名のみが表示され、Spring Bean 名は表示されません。

Java および .NET エージェントがルールを評価するデフォルトの順序を逆にします。true の場合、除外ルールは一致ルールの前に評価されます。

診断 POJO データコレクタからユーザーデータを同期して収集します。再起動の必要はありません。

リーク評価のために収集がキャプチャされる、サーバーの再起動以降の合計間隔（分単位）。プロパティはノード再起動後に有効になります。

このプロパティを使用して、カスタムアクティビティ相関ルールを custom-activity-correlation.xml で指定された形式で追加します。

このプロパティを使用して、カスタム インターセプタ ルールを custom-interceptors.xml で指定された形式で追加します。

または、カスタム インターセプタ ルールを custom-interceptors.xml に直接設定することもできます。Java エージェントは最新の変更を考慮します。