アプリエージェントのノードプロパティ(T ~ Z)

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

sensitive-data-filters

app-agent-config.xml で指定された XML 形式でフィルタを追加します。このノードプロパティは、 app-agent-config.xml の機密フィルタ設定を上書きせず、コントローラに送信される環境変数およびシステムプロパティには適用されません。
タイプデフォルト値プラットフォーム
文字列なしJava

<sensitive-data-filters>
<sensitive-data-filter applies-to="http-headers,http-cookies,jmx-mbeans"
match-type="CONTAINS"
match-pattern="user"/>
</sensitive-data-filters>

sensitive-message-filters

app-agent-config.xml で指定された XML 形式でフィルタを追加します。このノードプロパティは、他のノードプロパティをオーバーライドしません。
タイプデフォルト値プラットフォーム
文字列なしJava

<sensitive-message-filters>
        <sensitive-message-filter message-type="throwable,logger-message,all"
                                  match-type="EQUALS|CONTAINS|STARTSWITH|ENDSWITH|REGEX"
                                  match-pattern="CASESENSITIVE_PATTERN"
                                  redaction-regex="SENSITIVE_INFO_REGEX_GROUP"/>
     </sensitive-message-filters>

sensitive-url-filters

app-agent-config.xml で指定された XML 形式でフィルタを追加します。app-agent-config.xmlこのノードプロパティは、 からの機密フィルタ構成をオーバーライドしません。
タイプデフォルト値プラットフォーム
文字列なしJava

<sensitive-url-filters>
        <sensitive-url-filter delimiter="/"
                                  segment="2,3"
                                  match-filter="EQUALS|INLIST|STARTSWITH|ENDSWITH|CONTAINS|REGEX|NOT_EMPTY"
                                  match-pattern="pattern"
                                  param-pattern=""/>
    </sensitive-url-filters>

show-packages

このノードでキャプチャされたコールグラフについては、グローバルコールグラフ構成で構成されたものに加え、指定されたパッケージまたはクラス名を表示します。再起動は必要ありません。
タイプデフォルト値プラットフォーム
文字列なしJava、.NET

slow-request-deviation

現在の平均応答時間の偏差を表すミリ秒単位の値。この設定は、遅延している実行中のトランザクションの評価に使用されます。詳細は、slow-request-threshold プロパティも参照してください。
タイプデフォルト値範囲プラットフォーム
整数200最小値 = 10、最大値 = 3600Java、.NET

slow-request-monitor-interval

このプロパティが指定する間隔で、実行中のリクエストの遅延がチェックされます。値はミリ秒単位で指定されます。
タイプデフォルト値範囲プラットフォーム
整数100最小値 = 0、最大値 = 3600Java、.NET

slow-request-threshold

このしきい値(ミリ秒単位)よりも時間がかかり、かつ現在の平均応答時間について slow-request-deviation プロパティよりも大きな偏差がある実行中のリクエストがモニタリングされ、ホットスポットがキャプチャされます。
タイプデフォルト値範囲プラットフォーム
整数500最小値 = 0、最大値 = 3600Java、.NET

socket-enabled

.NET および Java アプリケーションの NetViz モニタリングを有効にするには、このプロパティを使用します。
タイプデフォルト値プラットフォーム
ブーリアンfalse(.Net)true(Java).NET、Java

SpringActuatorPort

spring-actuator-portINLINEtrue70%このプロパティを使用して、アプリケーションメトリックを取得するために Java エージェントがクエリを実行するデフォルトポートを変更します。
タイプデフォルト値プラットフォーム
整数8080Java

spring-batch-enabled

このプロパティを使用して、Spring Batchに対するOOTB BT検出を有効または無効にします。
タイプデフォルト値プラットフォーム
ブーリアンtrueJava

spring-integration-receive-marker-classes

このプロパティを使用して、Spring Integrationに適切なPOJOエントリとして判断したクラスとメソッドを指定します。

MessageHandler インターフェイスに基づいて、Java のアプリケーション エージェントは、デフォルトで自動的に「DirectChannel」以外のすべてのチャネルの終了を検出します。最初の MessageHandler が実行される前に、多数のアプリケーションフローが発生する場合は、

アプリケーションコードがループ内のメッセージのポーリングを行う場合、各ループの繰り返しスパンはトランザクションとして追跡されます。ループが始まるとトラッキングが開始され、繰り返しが終了するとループも終了します。pollableChannel.receive() がループ内で呼び出されない事象を防ぐには、ループ内のメッセージのポーリングを行う各クラス/メソッドの組み合わせに対して、このプロパティを指定します。

このプロパティを設定したら、このプロパティの変更を反映させるためにアプリケーションサーバーを再起動してください。

タイプデフォルト値プラットフォーム
完全修飾クラス/メソッド名のカンマ区切りの文字列(たとえば、spring-integration-receive-marker-classes = ,<> ....,<> ....)なしJava

たとえば、以下のトラッキングを有効にするには

class MessageProcessor
{
void process()
{
   while(true)
   {
          Message message = pollableChannel.receive()
   }
}
}
このプロパティを次のように設定します。
spring-integration-receive-marker-classes = MessageProcesser/process

Spring IntegrationサポートSpring Integrationサポート

spring-mvc-naming-scheme

Spring MVCトランザクションの命名スキームを変更するには、このノードプロパティを登録します。Bean IDはグローバル命名タイプとして使用できません。グローバルにはBean IDおよびメソッド名を使用します。
タイプ使用可能な値デフォルト値プラットフォーム
文字列bean-id、simple-class-name、fully-qualified-class-name、business-interface-name、bean-method-name、ben-id-and-method-name、class-and-method-nameなしJava

thread-correlation-classes

マルチスレッド アプリケーションの場合、単純なプレフィックスマッチング(STARTSWITH でのマッチング)でクラスを識別できる場合は、このプロパティを使用して、Java スレッド相関に含まれるクラスを構成します。

thread-correlation-classes プロパティは、スレッド相関に含まれるクラスを指定します。このプロパティは、thread-correlation-classes-exclude プロパティとともに使用できます。

構成された相関関係は、管理アプリケーションを再起動しなくても反映されます。「Java エージェントのスレッドの関連付けの構成」も参照してください。

タイプデフォルト値プラットフォーム
完全修飾クラス名またはパッケージ名のコンマで区切られた文字列なしJava

このプロパティは、Executor モードでの使用は推奨されません。

thread-cpu-capture-overhead-threshold-in-ms

1000回繰り返しのスレッドCPU時間を収集して計算するために割り当てられたタイムアウトを決定します。タイムアウトを超えると、Java エージェントはスレッドの CPU 時間の収集を自動的に無効にします。CPU 使用率情報は、コントローラ UI の BT の概要またはスナップショットには存在しません。また、以下のような INFO レベルログがログに表示されます。
[Thread-0] 22 Oct 2013 14:19:26,346 INFO JVMThreadCPUTimeCalculator - Disabling BT CPU Monitoring. Time taken to calculate Thread CPU Time for [1000] iterations is [15 ms] which is greater than the allowed budget of [10 ms].

getCurrentThreadCpuTime が Windows Linux より大幅に遅いという問題により、この問題は特に Linux の JDK 1.6 に影響を与えることがあります。

タイプ デフォルト値 プラットフォーム
整数 10 ms Java

thread-cpu-capture-overhead-threshold-in-mscpu プロパティを増やすことができますが、アプリケーションのオーバーヘッドが増加する可能性があることに注意してください。API コール自体の速度を上げるのではなく、この Java HotSpot VM オプションを使用することを推奨しています。

-XX:+UseLinuxPosixThreadCPUClocks

この値を変更した場合は、再起動が必要です。

thread-correlation-classes-exclude

マルチスレッド アプリケーションの場合、単純なプレフィックスマッチング(STARTSWITH でのマッチング)でクラスを識別できる場合は、このプロパティを使用して、Java スレッド相関から除外されるクラスを構成します。このプロパティは、スレッド相関から除外するクラスを指定します。このプロパティは、thread-correlation-classes ノードプロパティと組み合わせて使用できます。

構成された相関関係は、管理アプリケーションを再起動しなくても反映されます。Java エージェントのスレッドの関連付けの構成 を参照してください。

タイプ デフォルト値 プラットフォーム
完全修飾クラス名またはパッケージ名のコンマで区切られた文字列 なし Java

このプロパティは、Executor モードでの使用は推奨されません。

websocket-entry-calls-enabled

falseに設定すると、WebSocketエントリコールは検出されません。
タイプデフォルト値プラットフォーム
ブーリアンtrueJava

wcf-enable-eum

WCFノードからのEUM相関を有効または無効にします。
タイプデフォルト値プラットフォーム
ブーリアンfalse.NET

EUM 相関を有効にするには、WCF アプリケーションの Web.Config に以下のエントリも必要です。

 <serviceHostingEnvironment aspNetCompatibilityEnabled="true" />

serviceHostingEnvironment」を参照してください。