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

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

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

nested-exception-message-depth

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

normalize-prepared-statements

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

nservicebus-single-threaded

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

osb-ignore-exit-types

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

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

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

on-demand-snapshots

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

percentile-method-option

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

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

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

prometheus-metric-uri

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

prometheus-metric-report-initial-delay

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

prometheus-metric-report-interval

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

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

CODE
metricName*scalingFactor>newMetricName,metricName2*scalingFactor2>newMetricName2

CODE
http_request_latency_in_sec*1000>http_request_latency_in_ms

prometheus-metric-drop-labels

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

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

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

CODE
netty_allocator_pooled_cache_size#id

prometheus-metric-drop-metrics

Configure this node property to disable (drop) Prometheus metrics by specifying a regular expression (regex) pattern. Any Prometheus metric whose name matches the regex is excluded from collection and reporting. This helps reduce the total number of collected metrics and allows you to focus on only the metrics relevant to your use case.
注:
  • This property complements the existing prometheus-metric-drop-labels property, which allows you to remove specific labels from metrics.
  • Use this property if you want to completely disable or exclude certain metrics from being collected.

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 を設定します。

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

read-only-environment

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

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

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

reportingFrequencyInMillis

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

rest-num-segments

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

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-segments Java

rmqsegments

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

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

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