アプリケーション エージェントのノードプロパティ(N ~ R)

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

一般に、エージェントのデフォルト設定を変更する場合は気を付けてください。エージェントに対して指定された上限を増やす場合は、変更後のエージェントによるメモリ消費を注意深く評価およびモニタリングする必要があります。

nested-exception-message-depth

ネストされた例外メッセージが無視されるレベルを定義します。
タイプデフォルト値プラットフォーム
整数10Java、.Net

normalize-prepared-statements

このフラグを true に設定した場合、クエリテキストがスナップショットに追加される前に、プリペアドステートメント SQL の変数は「?」に置換されます。
タイプデフォルト値プラットフォーム
ブーリアンtrueJava

nservicebus-single-threaded

NServiceBus メッセージキューのスレッディング アーキテクチャを指定します。値はデフォルトで true に設定されています。マルチスレッドキューの実装では、値を false に変更します。.NETのNServiceBusバックエンド .NETのNServiceBusバックエンド
タイプデフォルト値プラットフォーム
ブーリアンtrue.Net

osb-ignore-exit-types

このカンマ区切りのプロパティは、関連性のないカスタムバックエンドとして検出から除外する終了プロトコル([Transport Configuration] ペインで設定されている)を定義します。

終了を検出しない場合は、プロパティを [all] に設定します。

タイプデフォルト値プラットフォーム
文字列http、jmsJava

on-demand-snapshots

このノードで実行されるすべてのビジネストランザクションのスナップショットを収集します。再起動は必要ありません。このプロパティは、開発モードでは無視されます。
タイプデフォルト値プラットフォーム
ブーリアンfalseJava、.Net

percentile-method-option

Splunk AppDynamics では、2 つの異なるアルゴリズムのうち 1 つを選択してパーセンタイルを計算します。
  • P Square アルゴリズム(デフォルト):このオプションでは、ストレージの消費量と発生する CPU のオーバーヘッド量が最も少なくなります。計算されるパーセンタイルの精度は、応答時間の分布の性質によって変化します。提示されるパーセンタイルの精度が不明な場合以外は、このオプションを使ってください。
  • Quantile Digest アルゴリズム:このオプションでは、消費されるストレージと CPU のオーバーヘッドが少しだけ増えますが、応答時間の分布次第ではパーセンタイルが向上する可能性があります。

このプロパティを変更しても、エージェントを再起動する必要はありません。

タイプサポートされる値デフォルト値プラットフォーム
数値
  • 1:P Square
  • 2:Quantile Digest
1Java、.Net

prometheus-metric-uri

このプロパティは、デフォルトの Prometheus エンドポイントを設定します。
タイプデフォルト値プラットフォーム
文字列``http://localhost:8080/metrics``Java

prometheus-metric-report-initial-delay

このプロパティは、メトリックレポートの初期遅延を秒単位で設定します。
タイプデフォルト値プラットフォーム
整数60Java

prometheus-metric-report-interval

このプロパティは、0 ~ 1 の間の浮動小数点値を表示するようにメトリックをスケーリングします。

スケールされたメトリックの名前を変更することもできます。次の設定形式を使用します。

metricName*scalingFactor>newMetricName,metricName2*scalingFactor2>newMetricName2

http_request_latency_in_sec*1000>http_request_latency_in_ms

prometheus-metric-drop-labels

メトリックラベルを削除するには、このプロパティを設定します。これにより、メトリックの合計数が減少します。メトリック名が指定されていない場合、ドロップ設定はすべてのメトリックに適用されます。名前が変更された場合は、元のメトリック名を使用します。

次の設定形式を使用します。

labelName1,labelName2;metricName#labelName1,labelName2;metricName2#labelName1,labelName2

netty_allocator_pooled_cache_size#id

quarkus-scheduled-annotation-discovery

注: このドキュメントには、サードパーティのドキュメントへの参照が含まれています。Splunk AppDynamics はいかなる権利も所有しておらず、そのようなサードパーティのドキュメントの正確性または完全性について責任を負いません。
Quarkus のスケジュールタスクをエントリポイントとして自動的にインストゥルメント化できるようにするには、このプロパティを true に設定します。定期的なタスクをスケジュールする方法の詳細については、「Scheduling Periodic Tasks」を参照してください。
タイプ デフォルト値 プラットフォーム
ブーリアン false Java

queue-single-threaded

IBM MQメッセージキューのスレッディングアーキテクチャを指定します。値はデフォルトで false に設定されています。

IBM MQ Get() メソッドが呼び出されると、トランザクション/スナップショットが途中で終了します。これを防止するには、エージェント ノード プロパティ queue-single-threaded=true を設定します。

タイプデフォルト値プラットフォーム
ブーリアンfalseJava、.Net

read-only-environment

デフォルトでは、Java エージェントは Azure Spring Cloud などの読み取り専用環境を識別し、それに応じて機能します。ただし、このプロパティを使用すると、環境を読み取り専用として扱うかどうかを手動で指定できます。

true/false に設定すると、デフォルトの検出メカニズムがオーバーライドされ、指定された読み取り専用設定が適用されます。これは、エントリを保存し、エージェントの再起動中のビジネストランザクションの損失を防ぐために役立ちます。

タイプデフォルト値プラットフォーム
ブーリアンなしJava

reportingFrequencyInMillis

このエージェントプロパティは、エージェントからセグメントデータのリクエスト(RSD)をアップロードする頻度を指定します。
タイプデフォルト値プラットフォーム
数値10000 msJava

rest-num-segments

プロパティ rest-num-segments は、rest-uri-segment-scheme で最初の n セグメントパラメータの n を指定します。rest-uri-segment-scheme このプロパティが 0 以下の場合、プロパティの値は無視されます。このプロパティの値は、rest-uri-segment-scheme=full の場合も無視されます。
タイプデフォルト値プラットフォーム
文字列2Java

rest-transaction-naming

このノードプロパティは、RESTベースのビジネストランザクションの命名形式を指定します。変数を使用して、実行時にバインドされた値で名前を設定できます。変数とマッチしないプロパティ値の文字は、ビジネストランザクション名のリテラルテキストとして処理されるため、たとえば、コロン、スラッシュ、または別の文字で変数を区切ることができます。

エージェントは各パラメータを取得し、Java クラスの注釈とプロパティに基づいて適切な値を書き込みます。

  • {class-name}:アプリケーション エージェントは、REST リソースにマッピングされた Java クラスの名前を書き込みます。
  • {method-name}:呼び出されるメソッド。
  • {class-annotation}:クラスの注釈値。
  • {method-annotation}:メソッドに適用されるメソッド注釈(常にあるとは限りません)。
  • {rest-uri}:REST リソースの URI。REST URIは以下のプロパティを使用して構成されます。
  • {http-method}:リクエスト、GET、POST などの HTTP メソッド。
  • {param-%d}:位置によって識別されるメソッドのパラメータ。%d をパラメータの位置に置き換えます(ゼロベース)。
タイプデフォルト値プラットフォーム
文字列{class-annotation}/{method-annotation}.{http-method}Java

ビジネストランザクション命名スキーム を参照してください。

rest-uri-segment-scheme

プロパティ rest-uri-segment-schemeurifirst-n-segments には、last-n-segmentsfull、 の 3 つの有効な値があります。このプロパティは、{rest-uri} の URI で使用する URI のセグメント数を示します。{rest-uri} このオプションは、大文字と小文字が区別されます。このプロパティが 0 以下の場合、プロパティの値は無視されます。fullrest-num-segments
タイプデフォルト値プラットフォーム
文字列first-n-segmentsJava

rmqsegments

.NET用アプリケーションエージェント(エージェント)は自動的にRabbitMQリモートサービスを検出します。rmqsegmentsノードプロパティを使用して、キューのバックエンド名を調整し、ルーティングキーの一部またはすべてのセグメントを含むようにします。実装しているRabbitMQ交換とルーティングキーに精通している必要があります。「RabbitMQ 交換と交換の種類」を参照してください。

RabbitMQのルーティングキーは文字列です。エージェントはルーティングキーのドット(.)で区切られているサブ文字列をセグメントとして扱います。rmqsegmentsの値を、名前に含めるルーティングキーセグメントの数を表す整数に設定します。バックエンド命名の修正の詳細については、「.NET の RabbitMQ バックエンド」を参照してください。

タイプデフォルト値プラットフォーム
数値名前に含めるルーティングキーセグメントの数を表す整数0.Net