AppDynamics では、マシンエージェントを柔軟に設定できます。これにより、デプロイ環境に最もフィットするものを選択できます。 

すべてのプロパティですべてのオプションを使用できるわけではありません。詳細については、マシンエージェントの設定プロパティを参照してください。 

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

マシンエージェントは、次の方法で設定できます。

  • <machine_agent_home>/conf ディレクトリの controller-info.xmlファイルを編集する。
  • マシンエージェントの起動スクリプトまたはコマンドラインで、エージェントのシステムプロパティ(-D<system_property>)を追加する。
  • 環境変数を使用する。環境変数を使用してエージェントを設定するには、モニタ対象アプリケーションが実行されている環境で環境変数の値を設定し、エージェントを再起動します。ほとんどのエージェント設定の環境変数は、controller-info.xml file に存在しますが、環境変数を使用してすべての設定を構成できるわけではありません。そのような設定については、システムプロパティまたは controller-info.xml を使用する必要があります。詳細については、マシンエージェントの設定プロパティを参照してください。

マシンエージェントのホームディレクトリへのフルパスまたはディレクトリ名自体では、空のスペースと特殊文字は使用できません。マシンエージェントが起動しない場合、パスに空のスペースまたは特殊文字が含まれていないかどうかを確認します。たとえば、パス /opt/appdynamics/machine agent には問題がありますが、パス /opt/appdynamics/machine-agent は正常に機能します。

JVM のシステムプロパティと環境変数は、controller-info.xml ファイル内の設定よりも優先されます。エージェントは、設定プロパティに空ではない最初の値を適用します。マシンエージェントは、次のソースを使用して設定を順番に適用します。  

  1. 環境変数
  2. JVM start コマンドで渡されるシステムプロパティ
  3. グローバル構成ファイル:<machine-agent-home>/conf/controller-info.xml


OS 環境およびインストールパッケージの詳細については、「マシンエージェント構成の指定場所」を参照してください

構成例

マシンエージェントの controller-info.xml ファイル

<?xml version="1.0" encoding="UTF-8"?>
<controller-info>    <controller-host>your-controller-host</controller-host>
    <controller-port>your-controller-port</controller-port>   
    <account-access-key>your-access-key<account-access-key>
    <controller-ssl-enabled>true</controller-ssl-enabled>
    <enable-orchestration>false</enable-orchestration>
    <sim-enabled>false</sim-enabled>
    <unique-host-id>your-host-id</unique-host-id>  
    <account-name>your-account-name</account-name>
</controller-info>
XML

bash コマンドラインの例

<machine_agent_home>/bin/machine-agent -Dappdynamics.controller.hostName=your-controller-host 
-Dappdynamics.controller.port=your-controller-port -Dappdynamics.agent.accountAccessKey=your-access-key -Dappdynamics.agent.uniqueHostId=your-host-id -Dappdynamics.agent.accountName=your-account-name
BASH