アプリケーション エージェントのノードプロパティ(B ~ C)
この参照資料のページには、アプリエージェントのノードプロパティに関する情報が記載されています。プロパティはアルファベット順に並んでいます。
bci-log-config
YYYY_MM_DD_HH_mm_ss と表示されます。Nはゼロから増えていきます。| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| 文字列 | 20、5、4 | Java |
例
ByteCodeTransformer.2012_09_12_20_17_57.0.log
ファイルサイズは15秒ごとにチェックされるため、ロールオーバーされる前のファイルは、指定されたしきい値よりやや大きくなることがあります。
生成された最初のログファイルは、次のように名前が付けられます。 ByteCodeTransformer.<timestamp>.0.log
このプロパティ値のフォーマットをデフォルト値 20,5,4 で説明します。それぞれの数字のセグメントには次のような意味があります。
- 20 は最初のログファイル(.0 バージョン)のサイズで、MB 単位
- 5は2番目以降の各ローリングファイルのサイズで、MB単位
- 4はキープするByteCodeTransformerログファイルの数
bciengine-disable-retransformation
bciengine-disable-retransformation を true に設定します。| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java |
boot-amx
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java |
callgraph-granularity-in-ms
| タイプ | デフォルト値 | 範囲 | プラットフォーム |
|---|---|---|---|
| 整数 | 0 | 最小値 = 0、最大値 = 5000 | Java、.NET |
capture-404-urls
このプロパティは404エラーの原因となるURLの取得を無効または有効にします。そのURLは15分ごとにERRORイベントとして報告され、イベントビューアで表示できます。JVMバージョンの再変換がサポートされていない場合、JVMを再起動する必要があります。
通常、404 エラーは、アプリケーションコードが実行されないことを意味します。その結果、スナップショット内でキャプチャされることはありません。このプロパティを true に設定することで、404 エラーに関するインサイトを得ることができます。404 エラーの原因となったすべての URL が報告されます。
capture-404-urls ノードプロパティは、AppDynamics v. 3.6 で廃止され、Splunk AppDynamics に置き換えられています。capture-error-urls
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java |
capture-error-urls
このプロパティは、以下のHTTPエラーのキャプチャを有効または無効にします。
- 401 - Unauthorized
- 500 - 内部サーバー エラー
- 404 - Page Not Found
- その他すべてのエラーコードは、一般的なHTTPエラーコードバケットに入ります。
これら4つのカテゴリについては、エージェントが毎分カテゴリあたり25個までURLを収集し、5分ごとにイベントを送信します。
Troubleshoot > Errors > Exceptions タブ > HTTP Error Codeをクリックし、エラーコードをドリルダウンするとこれらのURLが表示されます。
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | true | Java |
capture-raw-sql
capture-raw-sql が有効な場合、動的パラメータ(疑問符パラメータなど)を持つ SQL コールはエージェントによりキャプチャされ、ランタイムの値にバインドされた動的パラメータとともにコントローラ UI に表示されます。| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java、.NET |
例
たとえば、次のようにSQLコールを構成するJavaコードを見てみましょう。
stmt = new PreparedStatement("select * from user where ssn = ?")
stmt.bind(1, "123-123-1234")
stmt.execute()
capture-raw-sqlが有効な場合、AppDynamicsは次の形式でSQLコールをキャプチャします。Splunk AppDynamics
select * from user where ssn = '123-123-1234'
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'")
IBM JVMを使用する環境でこのノードプロパティを変更した場合、JVMを再起動する必要があります。この機能には特定のJDBCクラスの再変換が必要ですが、IBMエージェントではそれができないためです。
オプションをエージェントプロパティとして設定すると、ノードのSQLキャプチャモードに影響を与えます。コールグラフ設定 にある [Capture Raw SQL] オプションを使用すると、すべてのノードの動作を設定できます。
capture-set-status
setStatus() デフォルトでは、エージェントによって sendError() のみがインストゥルメント化されます。| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java |
capture-spring-bean-names
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | true | Java |
check-bt-excludes-early
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | false | Java、.NET |
collect-user-data-sync
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| ブーリアン | true | Java |
collection-capture-period-in-minutes
| タイプ | デフォルト値 | 範囲 | プラットフォーム |
|---|---|---|---|
| 整数 | 30 | 最小値 = 5、最大値 = N/A | Java |
custom-activity-correlation-rules
custom-activity-correlation.xml.| Type | Default value | Platform(s) |
|---|---|---|
| String | none | Java |
custom-interceptors-rules
このプロパティを使用して、custom-interceptors.xml で指定された形式でカスタム インターセプター ルールを追加します。
custom-interceptors.xmlまたは、カスタム インターセプター ルールを に直接設定することもできます。Java エージェントは最新の変更を考慮します。
| タイプ | デフォルト値 | プラットフォーム |
|---|---|---|
| 文字列 | なし | Java |