Versions Compared

    Key

    • This line was added.
    • This line was removed.
    • Formatting was changed.
    Comment: Published by Scroll Versions from this space and version 20.6
    Sv translation
    languageen
    Appd tocbox

    Related pages:

    AppDynamics provides flexibility for configuring the Machine Agent so that you can choose the best fit for your deployment environment. 

    Not all options are available for all properties. See Standalone Machine Agent Configuration Properties

    Configure the Machine Agent Properties

    You can configure the Machine Agent by:

    • Editing the controller-info.xml file located in the <machine_agent_home>/conf directory.
    • Adding Agent system properties (-D<system_property>) to the Machine Agent start-up script or on the command line.
    • Using environment variables. To configure the Agent with environment variables, set the value of the environment variable in the environment where the monitored application runs and restart the Agent. Environment variables exist for most of the Agent settings in the controller-info.xml file, but not all settings are configurable through environment variables. For those settings, you need to use system properties or controller-info.xml. See Standalone Machine Agent Configuration Properties
    Note

    Empty spaces and special characters are not allowed in either the full path to the Machine Agent home directory, or in the directory name itself. If the Machine Agent does not start up, review the path to determine if it contains empty spaces or special characters. For example, the path /opt/appdynamics/machine agent is problematic, however, the path/opt/appdynamics/machine-agent works correctly.

    The JVM system properties and environment variables override the settings in the controller-info.xml file. The Agent applies the first non-empty value for a configuration property. The Machine Agent applies configurations using the following sources (in order).  

    1. Environment variables
    2. System properties passed in the start command for the JVM
    3. Global configuration file: <machine-agent-home>/conf/controller-info.xml

    See Where to Specify Machine Agent Configuration for OS environment and install package details

    Anchor
    example-configuration
    example-configuration
    Example Configuration

    Machine Agent controller-info.xml File

    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8"?>
    <controller-info>
    
    	<controller-host>192.10.10.10</controller-host>
    	<controller-port>8090</controller-port>    
        <account-access-key>165e65645-95c1-40e3-9576-6a1424de9625<account-access-key> 
    	<controller-ssl-enabled>false</controller-ssl-enabled>
    	<enable-orchestration>false</enable-orchestration>
        <sim-enabled>false</sim-enabled> 
        <unique-host-id>your-host-id</unique-host-id>   
        <!-- The following account-related parameter is necessary only for SaaS installations-->
    	<!--account-name></account-name-->	
    
    </controller-info> 


     bash command-line example 

    No Format
    <machine_agent_home>/bin/machine-agent -Dappdynamics.controller.hostName=192.10.10.10 
    -Dappdynamics.controller.port=8090 -Dappdynamics.agent.accountAccessKey=165e65645-95c1-40e3-9576-6a1424de9625 -Dappdynamics.agent.uniqueHostId=your-host-id

    Sv translation
    languageja
    Appd tocbox

    On this page:

    Table of Contents
    maxLevel2
    minLevel2

    Related pages:

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

    すべてのプロパティですべてのオプションを使用できるわけではありません。詳細については、「Standalone Machine Agent Configuration Properties」を参照してください。

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

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

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

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

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

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


    各 OS 環境およびインストールパッケージの詳細については、Where to Specify Machine Agent Configuration」を参照してください。

    Anchor
    example-configuration
    example-configuration
    構成例

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

    Code Block
    languagexml
    <?xml version="1.0" encoding="UTF-8"?>
    <controller-info>
    
    	<controller-host>192.10.10.10</controller-host>
    	<controller-port>8090</controller-port>    
        <account-access-key>165e65645-95c1-40e3-9576-6a1424de9625<account-access-key> 
    	<controller-ssl-enabled>false</controller-ssl-enabled>
    	<enable-orchestration>false</enable-orchestration>
        <sim-enabled>false</sim-enabled> 
        <unique-host-id>your-host-id</unique-host-id>   
        <!-- The following account-related parameter is necessary only for SaaS installations-->
    	<!--account-name></account-name-->	
    
    </controller-info> 

     

    bash コマンドラインの例

    No Format
    <machine_agent_home>/bin/machine-agent -Dappdynamics.controller.hostName=192.10.10.10 
    -Dappdynamics.controller.port=8090 -Dappdynamics.agent.accountAccessKey=165e65645-95c1-40e3-9576-6a1424de9625 -Dappdynamics.agent.uniqueHostId=your-host-id