この参照資料のページには、アプリエージェントのノードプロパティに関する情報が記載されています。プロパティはアルファベット順に並んでいます。


bci-log-config

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

 
Type文字列
Default value:20、5、4
Platform(s):Java

Examples

ByteCodeTransformer.2012_09_12_20_17_57.0.log
CODE

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

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

このプロパティ値のフォーマットをデフォルト値 20,5,4 で説明します。それぞれの数字のセグメントには次のような意味があります。

  • 20 は最初のログファイル(.0 バージョン)のサイズで、MB 単位
  • 5は2番目以降の各ローリングファイルのサイズで、MB単位
  • 4はキープするByteCodeTransformerログファイルの数

bciengine-disable-retransformation

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

Typeブール
Default value:false
Platform(s):Java

boot-amx

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

Typeブール
Default value:false
Platform(s):Java

callgraph-granularity-in-ms

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

Type整数型(Integer)
Default value:0
Range:最小値 = 0、最大値 = 5000
Platform(s):Java、.NET

capture-404-urls

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

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

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

Typeブール
Default value:false
Platform(s):Java

capture-error-urls

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

  • 401 - Unauthorized
  • 500 - 内部サーバー エラー
  • 404 - Page Not Found
  • その他すべてのエラーコードは、一般的なHTTPエラーコードバケットに入ります。

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

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

Typeブール
Default value:true
Platform(s):Java

capture-raw-sql

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

Typeブール
Default value:false
Platform(s):Java、.NET

Examples

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

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

capture-raw-sqlが有効な場合、AppDynamicsは次の形式でSQLコールをキャプチャします。

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

capture-raw-sql が無効な場合、SQL コールは、値にバインドされていない疑問符パラメータとともに表示されます。 

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

重要な点としては、上記のように、SQL ステートメントの元のプリペアドステートメント形式で、機密の値をパラメータ化する必要があることに注意してください。次のステートメントでは、capture-raw-sql の有効または無効にかかわらず、UI に表示される潜在的に機密性の高い情報(ssn 値)が生成されます。   

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

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

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

capture-set-status

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

Typeブール
Default value:false
Platform(s):Java

capture-spring-bean-names

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

Typeブール
Default value:true
Platform(s):Java

check-bt-excludes-early

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

Typeブール
Default value:false
Platform(s):Java、.NET

collect-user-data-sync

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

Typeブール
Default value:true
Platform(s):Java

collection-capture-period-in-minutes

リークの評価についてコレクションがキャプチャされたサーバーの再起動以降の分単位の合計間隔。プロパティはノード再起動後に有効になります。

Type整数型(Integer)
Default value:30
Range:最小値 = 5、最大値 = N/A
Platform(s):Java

custom-activity-correlation

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

Type文字列
Default value:none
Platform(s):Java

custom-interceptor-rules

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

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

Type文字列
Default value:none
Platform(s):Java