マシンエージェントの設定プロパティ

このページでは、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 でメモリ使用量を計算するときに、ファイルキャッシュメモリを除外できます。

AIX に <-Dappdynamics.machine.agent.collect.memoryMetrics.using.vmstat.command = true> と <sim_enabled = true> を設定すると、ファイルキャッシュメモリを除外した後に、コントローラ UI でメモリ使用量のメトリックを取得します。

システムプロパティ: -

Dappdynamics.machine.agent.collect.memoryMetrics.using.vmstat.command

環境変数:該当なし

タイプ:ブール値

デフォルト:false

必須:いいえ