スマートエージェントの設定

コントローラに登録するには、スマートエージェントを設定する必要があります。コンフィギュレーション ファイルを編集します。たとえば、/opt/appdynamics /opt/appdynamics/appdsmartagent/config.ini でインストールファイルをダウンロードした場合。

config.ini

次は config.ini の例です。

CODE 
ControllerURL    = localhost
ControllerPort   = 8090
FMServicePort    = 8030
AgentType        =
AccountAccessKey =
AccountName      = e2e-customer
EnableSSL        = true

[Telemetry]
LogLevel  = info
LogFile   = log.log

[CommonConfig]
PollingIntervalInSec  = 300
ScanningIntervalInSec = 300

[Storage]
Directory =

[TLSClientSetting]
Insecure           = false
InsecureSkipVerify = false
AgentHTTPProxy     =
AgentHTTPSProxy    =
AgentNoProxy       =

[TLSSetting]
CAFile     =
CAPem      =
CertFile   =
CertPem    =
KeyFile    =
KeyPem     =
MinVersion = TLS 1.2
MaxVersion = TLS 1.3
IncludeSystemCACertsPool = true

[AutoDiscovery]
RunAutoDiscovery = true
ExcludeLabels = process.cpu.usage,process.memory.usage
ExcludeProcesses =
ExcludeUsers =
AutoDiscoveryTimeInterval = 4h

環境変数を使用したスマートエージェントの設定

スマートエージェントでは、環境変数を通じて柔軟な設定オプションが提供され、構成ファイルを直接変更することなくダイナミックに調整できます。環境変数の利用では、2 つの異なるメソッドがサポートされています。

設定のオーバーライド

環境変数は、スマートエージェントの config.ini ファイルで定義されている特定の値を直接オーバーライドできます。このメソッドは、設定をすばやく変更する場合に最適です。

スマートエージェントが起動すると、config.ini 設定に対応する定義済みの環境変数名がチェックされます。オーバーライド環境変数が存在する場合、その値は config.ini で指定された値よりも優先されます。必要な設定に対応するサポートされているオーバーライド環境変数については、以下のセクションにある設定の表を参照してください。

環境変数の拡張

設定キーの値として config.ini ファイル内に環境変数を直接埋め込むことができます。スマートエージェントは、スタートアップ時にこれらの変数を拡張してシステム定義の値に解決します。

これにより、スマートエージェントの実行環境からランタイム時に解決されるダイナミック設定値が可能になります。

スマートエージェントは、サポートされているシンタックスに従い、config.ini 値内の環境変数の拡張をサポートしています。

フォーマットの要件は次のとおりです。

  • ${ から始めます。
  • 必要に応じて、env: を続けて付けます。

  • 置換する環境変数の名前を続けて入力します。名前の形式は次のようにします。

    • 英文字または _ から始めます。
    • 任意の数の英数字または _ を続けて付けます。

  • 必要に応じて、デフォルト値を続けて付けます。デフォルト値の形式は次のようにします。

    • :- から始めます。
    • 常に DEFAULT-VALUE を付け、}を除いて、任意の数の印刷可能な文字と空白を指定できます。

  • } で終了します。

次に、環境変数 ACCESS_KEY が AccountAccessKey に対して定義され、環境変数 env:USE_SSL:-true が EnableSSL に対して定義された例を示します。
JSON 
AccountAccessKey = ${ACCESS_KEY}
EnableSSL        = ${env:USE_SSL:-true}
$$ を使用して、設定値内のリテラル文字 $ を示します。たとえば、e2e-customer$ のアカウント名を表すには、次のようにします。
CODE 
AccountName = e2e-customer$$

Basic Configuration

The basic configuration is the required configuration to register Smart Agent with Controller. Ensure that you update the following parameters for the basic Smart Agent configuration:

  • ControllerURL : The URL of the Controller on which you want to establish the connection with the Smart Agent.

  • ControllerPort: The port to which Controller connects to the Agent Management (FM service). The default port is 8090

  • FMServicePort: The port to which the Smart Agent connects to the FM service.

    It is 8030 for an on-premises Controller and 443 for the Virtual Appliance.

  • AccountAccessKey : The account access key on the Controller.
  • AccountName
  • EnableSSL : SSL is enabled by default. To turn off SSL, specify the value as false.
Parameter Environment Variables to Override Description
ControllerURL SUPERVISOR_CONTROLLER_URL The URL of the Controller on which you want to establish the connection with the Smart Agent.
ControllerPort SUPERVISOR_CONTROLLER_PORT The port to which Controller connects to the Agent Management (FM service). The default port is 8090
FMServicePort: SUPERVISOR_FM_SERVICE_PORT The port to which the Smart Agent connects to the FM service.

It is 8030 for an on-premises Controller and 443 for the Virtual Appliance.
AccountAccessKey SUPERVISOR_ACCOUNT_ACCESS_KEY The account access key on the Controller.
AccountName SUPERVISOR_ACCOUNT_NAME The name of the account on the Controller.
EnableSSL SUPERVISOR_ENABLE_SSL SSL is enabled by default. To turn off SSL, specify the value as false

詳細設定

要件に応じて、次の設定を使用できます。これらは必須パラメータではありません。スマートエージェントのインストール後にこれらの設定を含めることもできますが、設定を適用するにはスマートエージェントを再起動してください。

Proxy Configuration

If you require to configure the proxy settings, specify the following fields under the TLSClientSetting section of the config.ini file.

Parameter Environment Variables to Override Description Example
AgentHTTPProxy HTTP_PROXY specify the proxy URL for this parameter when you use an HTTP Controller.

myhostmyhost:3128
AgentHTTPSProxy HTTPS_PROXY specify the proxy URL for this parameter when you use an HTTPS Controller. myhost:8443
AgentNoProxy NO_PROXY specify comma-separated values for hosts that should be excluded from proxying . internal.example.com,internal2.example.com

HTTP proxy example

The following example is for using the HTTP proxy for the Smart Agent:

CODE 
[TLSClientSetting]
Insecure = false
AgentHTTPProxy  = localhost:3128
AgentHTTPSProxy =
AgentNoProxy    =

TLS構成

TLS 証明書を構成する必要がある場合は、config.ini の TLSSetting で次のフィールドを指定します。

パラメータ 設定をオーバーライドするための環境変数 説明 例
CAFile SUPERVISOR_CA_FILE ルート証明書ファイルへのパスを指定します。 <cert file path>/ca.crt
CertFile SUPERVISIOR_CERT_FILE ルート証明書ファイルへのパスを指定します。 <client cert file path>/clients .crt
KeyFile SUPERVISOR_KEY_FILE ファイルのクライアント秘密キーへのパスを指定します。 <private key file path>/private.key

ログレベルの設定

Telemetry セクションでログレベルの詳細を指定できます。次のいずれかのログレベルを使用できます。

  • debug
  • info
  • warn
  • error

テレメトリ

パラメータ 設定をオーバーライドするための環境変数 説明
LogLevel SUPERVISOR_LOG_LEVEL info などのログレベル。
LogFile SUPERVISOR_LOG_FILE ログファイルへのパス。

ログレベルの例

次に、info ログレベルを使用する例を示します。

CODE 
[Telemetry]
LogLevel=info
LogFile=
Profiling=false