スマートエージェントの設定
コントローラに登録するには、スマートエージェントを設定する必要があります。コンフィギュレーション ファイルを編集します。たとえば、/opt/appdynamics /opt/appdynamics/appdsmartagent/config.ini でインストールファイルをダウンロードした場合。
config.ini
次は config.ini の例です。
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環境変数を使用したスマートエージェントの設定
設定のオーバーライド
環境変数は、スマートエージェントの config.ini ファイルで定義されている特定の値を直接オーバーライドできます。このメソッドは、設定をすばやく変更する場合に最適です。
環境変数の拡張
設定キーの値として config.ini ファイル内に環境変数を直接埋め込むことができます。スマートエージェントは、スタートアップ時にこれらの変数を拡張してシステム定義の値に解決します。
これにより、スマートエージェントの実行環境からランタイム時に解決されるダイナミック設定値が可能になります。
スマートエージェントは、サポートされているシンタックスに従い、config.ini 値内の環境変数の拡張をサポートしています。
フォーマットの要件は次のとおりです。
${から始めます。- 必要に応じて、
env:を続けて付けます。 -
置換する環境変数の名前を続けて入力します。名前の形式は次のようにします。
- 英文字または
_から始めます。 - 任意の数の英数字または
_を続けて付けます。
- 英文字または
-
必要に応じて、デフォルト値を続けて付けます。デフォルト値の形式は次のようにします。
:-から始めます。- 常に
DEFAULT-VALUEを付け、}を除いて、任意の数の印刷可能な文字と空白を指定できます。
-
} で終了します。
ACCESS_KEY が AccountAccessKey に対して定義され、環境変数 env:USE_SSL:-true が EnableSSL に対して定義された例を示します。
AccountAccessKey = ${ACCESS_KEY}
EnableSSL = ${env:USE_SSL:-true}$$ を使用して、設定値内のリテラル文字 $ を示します。たとえば、e2e-customer$ のアカウント名を表すには、次のようにします。
AccountName = e2e-customer$$基本設定
基本設定は、スマートエージェントをコントローラに登録するために必要な設定です。基本的なスマートエージェントの設定の、次のパラメータを更新します。
| パラメータ | オーバーライドするための環境変数 | 説明 |
|---|---|---|
| controllerUrl | SUPERVISOR_CONTROLLER_URL | スマートエージェントとの接続を確立するコントローラの URL。 |
| ControllerPort | SUPERVISOR_CONTROLLER_PORT | コントローラがエージェント管理（FM サービス）に接続するポート。デフォルトポートは 8090 です。 |
| FMServicePort： | SUPERVISOR_FM_SERVICE_PORT | スマートエージェントが FM サービスに接続するポート。
SaaS コントローラの場合は |
| AccountAccessKey | SUPERVISOR_ACCOUNT_ACCESS_KEY | コントローラのアカウントアクセスキー。 |
| アカウント名 | SUPERVISOR_ACCOUNT_NAME | コントローラのアカウント名。 |
| EnableSSL | SUPERVISIOR_ENABLE_SSL | SSL はデフォルトで有効になっています。SSL をオフにするには、値を false に指定します。 |
詳細設定
要件に応じて、次の設定を使用できます。これらは必須パラメータではありません。スマートエージェントのインストール後にこれらの設定を含めることもできますが、設定を適用するにはスマートエージェントを再起動してください。
プロキシ設定
プロキシ設定を構成する必要がある場合は、config.ini ファイルの TLSClientSetting セクションで次のフィールドを指定します。
| パラメータ | オーバーライドするための環境変数 | 説明 | 例 |
|---|---|---|---|
| AgentHTTPProxy | HTTP_PROXY | HTTP コントローラを使用する場合は、このパラメータのプロキシ URL を指定します。 |
|
| AgentHTTPSProxy | HTTPS_PROXY | HTTPS コントローラを使用する場合は、このパラメータのプロキシ URL を指定します。 | myhost:8443 |
| AgentNoProxy | NO_PROXY | プロキシから除外する必要があるホストのカンマ区切り値を指定します。 | internal.example.com,internal2.example.com |
HTTP プロキシの例
次に、スマートエージェントの HTTP プロキシを使用する例を示します。
[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 ログレベルを使用する例を示します。
[Telemetry]
LogLevel=info
LogFile=
Profiling=false