他のプロパティ
オーケストレーションの有効化
trueに設定されている場合、アプリケーションサーバーがAppDynamicsオーケストレーションワークフローにより作成されるコンピュートクラウドインスタンスの場合、コントローラホストとポートの自動検出を有効にする。 「コントローラ ホスト プロパティ」 および 「コントローラ ポート プロパティ」を参照してください。
クラウドコンピュート環境で、ワークフローでマシンの作成タスクが正しく動作するために自動検出は必要です。
このエージェントが存在するホストマシンが Splunk AppDynamics ワークフロー オーケストレーションで作成されない場合、このプロパティを false に設定する必要があります。
Element in controller-info.xml:<enable-orchestration>
Type:ブール型
Default:False
Required: なし
エージェントのランタイムディレクトリ
エージェントが実行時に書き込むすべてのファイル用のディレクトリを設定します。このプロパティが指定されると、すべてのエージェントログは<Agent-Runtime-Directory>/logs/node-nameに書き込まれ、トランザクション構成は<Agent-Runtime-Directory>/conf/node-nameディレクトリに書き込まれます。ログフォルダの場所は、appdynamics.agent.logs.dir プロパティを使用して上書きできます。
Element in controller-info.xml: <agent-runtime-dir>
System Property: -Dappdynamics.agent.runtime.dir
Environment Variable: APPDYNAMICS_AGENT_BASE_DIR
Type:文字列
Default:<agent_home>/nodes
Required: なし
ログファイルをリダイレクト
ログが書き込まれる宛先ディレクトリを設定します。
System Property: -Dappdynamics.agent.logs.dir
Type:文字列
Default:<agent_home>/logs/<Node_Name>
Required: なし
エージェントの conf ディレクトリのカスタムパス
エージェントのconfディレクトリにカスタムパスを設定します。 エージェントが静的構成ファイルを読み取る場所です。custom-activity-correlation.xml または app-agent-config.xml を変更する必要があり、エージェントのインストールが読み取り専用の場合に、他の場所から静的構成ファイルを読み取るようエージェントに指示します。
System Property:-
Type:文字列
Default:<agent_home>/ver4.5.x.x.x/conf
Required: なし
エージェント登録の強制
次の条件に当てはまる場合にのみ true に設定します。
- エージェントがUIから新しいアプリケーションまたはティアに移動され、かつ
- エージェント構成で新しいアプリケーション名またはティア名を指定して、その移動をオーバーライドしたい場合。
Element in controller-info.xml: <force-agent-registration>
Type:ブール型
Default:False
Required: なし
自動ノード名プレフィックス
このプロパティは、指定したプレフィックスを使いコントローラにノード名を自動的に生成させる場合に設定します。
コントローラは、指定したプレフィックスとUUIDサフィックスを連結してノード名を生成します。たとえば、プレフィックスを以下のように指定すると、
-Dappdynamics.agent.auto.node.prefix=JoannaAutoNode
以下のノード名が生成されます。
JoannaAutoNode_d39dbfc1-6f4b-4eb7-a788-c1c0135b6bcb
このプロパティは、ノード名プレフィックス再利用のプロパティと同様の機能を提供します。ただし、このプロパティはノード名の再利用と組み合わせて使用されるものではありません。そのような場合には、代わりにノード名プレフィックス再利用のプロパティを使用します。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.agent.auto.node.prefix=<your_prefix>
Type:文字列
Default:コントローラによって管理されティア名に追加されたシリアル番号
Required: なし
自動ログディレクトリのクリーンアップ
Java エージェントで古いノードディレクトリを自動的に削除する場合は、このプロパティを設定します。デフォルトでは、このプロパティは無効になっていて、0 に設定されています。
エージェントを再起動するたびに、エージェントは、プロパティで指定された過去数時間更新されていない古いノードディレクトリを削除します。たとえば、次のようにプロパティを設定します。
-appdynamics.agent.log.dir.threshold.hours=4
次回のエージェントの再起動時に、エージェントは過去 4 時間に更新されていないノードディレクトリを削除します。
Element in controller-info.xml:該当なし
System Property: -appdynamics.agent.log.dir.threshold.hours
Type:整数
Default: 0
Required: なし
Cron/Batch JVM
このプロパティは、JVMがbatch/cronプロセスの場合にtrueに設定されます。このプロパティを使用して、シャットダウンする前にエージェントがメトリックを送信できるように、シャットダウンを遅らせます。
Element in controller-info.xml:該当なし
System Property: -Dappdynamics.cron.vm
Type:ブール型
Default:False
Required: なし
一意のホスト ID
アプリケーションが異なるマシンで実行されているコントローラに表示されるように、単一の物理ホストまたはバーチャルマシンを論理的に分割する。管理しているインフラストラクチャ全体をとおして一意の値を文字列に設定する。文字列に空白文字は使用できません。アプリケーションエージェントが監視するアプリケーションに関連付けられたマシンエージェントがある場合、このプロパティをマシンエージェント上で同じ値に設定しなければなりません。マシンエージェントのインストールのシナリオ マシンエージェントのインストールのシナリオ
System Property: -Dappdynamics.agent.uniqueHostId
Environment Variable: APPDYNAMICS_AGENT_UNIQUE_HOST_ID
Type:文字列
Default: なし
Required: なし
エージェントのメタ情報
任意の情報をノードに関連付けできます。これは、ノードごとに正常性ルールまたはポリシーを適用するための基礎として使用できます。たとえば、meta-info プロパティに基づいて、テストエージェントとしてタグ付けされたエージェントへの適用から正常性ルールを除外できます。key___value 形式でプロパティを渡します(例:"key1___value1")。
正常性ルールまたはポリシーで(組み込み meta-info プロパティとともに)プロパティを使用する際の詳細については、「 正常性ルールの構成」または「ポリシーの設定」を参照してください。
System Property: -Dappdynamics.agent.node.metaInfo
Type:文字列
Default: なし
Required: なし
低エントロピー
PRNGアルゴリズムのシードに使用可能な低からゼロのエントロピーを使用して、システム内のエージェントのスタートアップに関する問題を解決します。デフォルトでは true に設定されています。システムプロパティ appdynamics.low.entropy が設定されている場合は、SecureRandom を介して NativePRNGNonBlocking アルゴリズムを使用します。Windows は NativePRNGNonBlocking をサポートしておらず、既存の Secure Random 実装を引き続き使用するため、この変更の影響を受けません。
System Property: appdynamics.low.entropy=true
Element in controller-info.xml: なし
Environment Variable: なし
Type:ブーリアン
Default:True
Required: なし
appdynamics.low.entropy=true の場合、エージェントはエントロピーがない場合でも、乱数を生成する際にブロックされないようにするための対策を取ります。
たとえば、Java エージェント 20.11 以降、エージェントはデフォルトで NativePRNGNonBlocking を SecureRandom 実装として使用します。そのため、UUID 生成に非ブロッキング低エントロピーアルゴリズムを使用しようとします。NativePRNGNonBlocking は Windows ではサポートされておらず、SHA1PRNG の既存の実装がデフォルトです。
分析エージェント
リモート(またはデフォルトでない)分析エージェントでトランザクション分析機能を使用する場合。「リモート分析エージェントのアプリケーション サーバ エージェントの有効化」を参照してください。
System Property: -Dappdynamics.analytics.agent.url
Element in controller-info.xml: なし
Environment Variable: なし
Type:文字列
Default: http://localhost:9090/v2/sinks/bt
Required: なし
単純なホスト名の使用
デフォルトでは(uniqueHostId システムプロパティで上書きされない限り)、エージェントはリバース DNS ルックアップによって、それ自体が実行されている OS のホスト名を決定します。状況によっては、このホスト名がホスト名の完全修飾ドメイン名として設定されている場合があります。このプロパティが true に設定されている場合、エージェントはドメイン名を削除し、単純なホスト名を使用してホストを識別します。ホスト名が IP アドレスである場合(DNS ルックアップが失敗した場合に発生します)、文字列形式の完全な IP アドレスが使用されます。ホスト名は、マシンエージェントによって収集されたメトリックをアプリケーションノードにマッピングするために使用されます(「Unique Host ID Property」を参照)。
Element in controller-info.xml:<use-simple-hostname>
Type:ブール型
Default:False
Required: なし
For example:このプロパティが true に設定されている場合、'server.mydomain.com' は 'server' になります。
ダイナミックサービスの JAR 署名
True に設定すると、ダイナミックサービスの自動 JAR 署名が有効になります。また、ダイナミック サービス ワークフローの脆弱性を特定します。悪意のあるダイナミックサービスからのコードのロードと実行を防ぐためのチェックも提供します。False に設定すると、JAR 署名が無効になります。
Element in controller-info.xml:<enable-jar-signing>
Type:ブール型
Default:True
Required: なし
JVM ベンダーの識別
Java エージェントは、基盤となる JVM を自動的に識別します。誤って識別された場合は、このフラグを使用して、自動的に検出された JVM ベンダーをオーバーライドできます。このプロパティは、名前が変更された場合でも JVM を識別します。基盤となる JVM を識別するには、このプロパティを true に設定します。デフォルトでは、このプロパティは無効になっています。
Element in controller-info.xml:該当なし
System Property:-Dappdynamics.jvm.vendor
Type:文字列
Accepted Values:ibm、sun
Default: N/A
Required: なし
Java エージェントタグ
-Dappdynamics.disable.tags=true システムプロパティを使用してタグを無効にする必要があります。サポートされていないコントローラでタグを有効にすると、Java エージェントはコントローラに登録されません。
タグは、アプリケーション、ティア、ノードなどのエンティティに関連付けられているキーと値のペアです。これらのタグは、コントローラ UI でアプリケーションリソースを見つけるのに役立つメタデータとして機能します。適切なカスタムタグを使用してエンティティに関連する問題にタグ付けすることで、エンティティに関連する問題の平均検出時間(MTTD)を短縮できます。コントローラにタグをインポートする方法については、「カスタムタグ API」を参照してください。
Java エージェントタグは、システムプロパティまたは環境変数を使用してエージェント登録時に定義できます。競合する場合は、環境変数がシステムプロパティよりも優先されます。これらのタグはコントローラ UI に送信され、タグベースのフィルタリングとタグベースの列を使用してデータをフィルタリングするのに役立ちます。タグ付け設定を変更した場合は、エージェントを再起動する必要があります。
System Property: -Dappdynamics.entity.tag.*
次に、システムプロパティを使用したタグの例を示します。
-Dappdynamics.entity.tag.key1 = value1-Dappdynamics.entity.tag.key2 = value2
Environment Variable:APPDYNAMICS_ENTITY_TAG_*
次に、環境変数を使用したタグの例を示します。
APPDYNAMICS_ENTITY_TAG_key1=value1APPDYNAMICS_ENTITY_TAG_key2=value2
Type:文字列
Default: なし
Required:オプション
タグを無効化にするには、次のシステムプロパティを true に設定します。true
System Property: -Dappdynamics.disable.tags
Type:ブール型
Default:False
Required:オプション