マシンエージェントの設定プロパティ
このページでは、controller-info.xml の要素、コマンドラインまたはスタートアップスクリプトでのシステムプロパティのオプション、環境変数(該当する場合)など、エージェントの構成プロパティについて説明します。エージェントシステムのプロパティは、使用するオペレーティングシステムとインストールパッケージに基づいて構成します。
エージェントは、エージェント構成プロパティの変更に応じて動的に更新されるため、エージェントの再起動は不要です。
システムプロパティの構文
- システムプロパティは、大文字と小文字が区別されます
- スペースを含む値は、二重引用符で囲む必要があります
アカウントアクセスキー
コントローラの認証に使用されるアカウントアクセスキー。このキーはインストール時に生成され、[コントローラ設定(Controller Settings)] でライセンス情報を表示することでを確認できます。「ライセンス使用状況の確認」を参照してください。
controller-info.xml 内の要素:<account-access-key>
システムプロパティ: -Dappdynamics.agent.accountAccessKey
環境変数: APPDYNAMICS_AGENT_ACCOUNT_ACCESS_KEY
型:文字列
デフォルト:なし
必須:4.1 より前のバージョンでは、このプロパティは、SaaS およびマルチテナントコントローラにのみ必要でした。バージョン 4.1 以降では、コントローラ通信に対してすべてのエージェントを認証するために、アカウント アクセス キー プロパティが必要です。
例: -- Dappdynamics.agent.accountAccessKey=165e65645-95c1-40e3-9576-6a1424de9625
アカウント名
コントローラの認証に使用されるアカウント名。AppDynamics SaaS コントローラを使用する場合、アカウント名は AppDynamics から送信されるウェルカムメールで通知されます。
controller-info.xml 内の要素:<account-name>
システムプロパティ:-Dappdynamics.agent.accountName
環境変数:APPDYNAMICS_AGENT_ACCOUNT_NAME
型:文字列
デフォルト:なし
必須:AppDynamics SaaS コントローラとマルチテナントユーザーには必須で、シングルテナントモード(デフォルト)では必須ではありません。
エージェント ロギング ディレクトリ
非推奨。代わりに appdynamics.agent.logs.dir を使用する必要があります。動作はエージェント ログ ディレクトリの <appdynamics.agent.logs.dir>/logs/ と同じです。
システムプロパティ:-Dappdynamics.agent.logging.dir
環境変数:該当なし
型:文字列
デフォルト:なし
必須:いいえ
独立したマシンエージェントのインストールシナリオ
通常、AppDynamics アプリケーション エージェントがインストールされていないサーバにマシンエージェントをインストールする場合にのみ、次のプロパティを使用します。
アプリケーション名
このJVMノードが属する合理的なビジネスアプリケーションの名前。これはアプリケーションサーバ上のデプロイメント名(ear/war/jar)ではありません。構成された名前のビジネスアプリケーションが存在しない場合、自動的に作成されます。
controller-info.xml 内の要素:<application-name>
システムプロパティ:-Dappdynamics.agent.applicationName
環境変数:APPDYNAMICS_AGENT_APPLICATION_NAME
型:文字列
デフォルト:NONE
マシンエージェントのインストールのシナリオ マシンエージェントのインストールのシナリオ
ノード名
JVM ノードの名前。指定しない場合、デフォルトでは、マシンエージェントの Node1 になります。
controller-info.xml 内の要素:<node-name>
システムプロパティ:-Dappdynamics.agent.nodeName
環境変数:APPDYNAMICS_AGENT_NODE_NAME
型:文字列
デフォルト:NONE
マシンエージェントのインストールのシナリオ マシンエージェントのインストールのシナリオ
ティア名
この JVM ノードが属する論理階層の名前。これはアプリケーションサーバ上のデプロイメント名(ear/war/jar)ではありません。設定した名前の階層が存在しない場合、自動的に作成されます。
controller-info.xml 内の要素:<tier-name>
システムプロパティ:-Dappdynamics.agent.tierName
環境変数:APPDYNAMICS_AGENT_TIER_NAME
型:文字列
デフォルト:NONE
マシンエージェントのインストールのシナリオ マシンエージェントのインストールのシナリオ
メモリ使用量からのファイルキャッシュメモリの除外
次のシステムプロパティを使用して、サーバーの可視性が有効になっている AIX でメモリ使用量を計算するときに、ファイルキャッシュメモリを除外できます。
-Dappdynamics.machine.agent.collect.memoryMetrics.using.vmstat.command = true> と <sim_enabled = true> を設定すると、ファイルキャッシュメモリを除外した後に、コントローラ UI でメモリ使用量のメトリックを取得します。システムプロパティ: -
Dappdynamics.machine.agent.collect.memoryMetrics.using.vmstat.command
環境変数:該当なし
タイプ:ブール値
デフォルト:false
必須:いいえ