はじめに

サポートされているプラットフォームのリストについては、「サポートされるプラットフォーム」を参照してください。その他のスマートエージェントの要件については、「スマートエージェント」を参照してください。

このドキュメントには、Ansible® のドキュメントへの参照が含まれています。Splunk AppDynamics はいかなる権利も所有しておらず、そのようなサードパーティのドキュメントの正確性または完全性について責任を負いません。

次の表に、スマートエージェントの使用を開始する手順の概要を示します。

スマートエージェントの要件を確認します。
スマートエージェントのインストール
スマートエージェントの設定
スマートエージェントプロセスの開始
スマートエージェントのインストールの検証

スマートエージェントのインストール

各マシンにログインすることで、スマートエージェントをホストマシンにインストールできます。ダウンロードポータルからそれぞれのファイルを必要なホストマシンにダウンロードできます。

エージェント管理には、複数のホストへのスマートエージェントのインストールを自動化するために使用できる、スマートエージェント CLI があります。

次のコマンドを実行して、ホストマシンにスマートエージェントをインストールします。

Debian

/opt/appdynamics/appdsmartagent でファイルを解凍し、次のコマンドを実行します。

sudo [env [APPD_USER=<root-user>] [APPD_USER_GROUP=root] [APPD_SMARTAGENT_PYTHON3=<path to python>]] apt install ./appdsmartagent_<version>_amd64.deb

CODE

Centos/RHEL

/opt/appdynamics/appdsmartagent でファイルを解凍し、次のコマンドを実行します。

sudo [env APPD_USER=<root-user>] [APPD_USER_GROUP=root APPD_SMARTAGENT_PYTHON3=<path to python>]] yum install ./appdsmartagent_<version>_amd64.rpm

CODE

スマートエージェントは、RHEL 8 以降でサポートされています。

Linux zip

任意の場所でファイルを解凍し、次のコマンドを実行します。

sudo [env [APPD_USER=<root-user>] [APPD_USER_GROUP=root] [APPD_SMARTAGENT_PYTHON3=<path to python>]] ./install-script.sh

CODE

Windows

Windows zip ファイルを任意の場所に解凍します。
管理者としてコマンドラインを開きます。
appdsmartagent-service.batの実行バッチスクリプトが appdsmartagent Windows サービスを作成し、実行します。
このスクリプトを実行すると、スマートエージェントがホストマシン上で Windows サービスとして実行され続けます。

複数のホストにスマートエージェントをインストールするには、「複数ノードでのスマートエージェントのインストールの自動化」を参照してください。

変数の詳細を次の表に示します。

変数名	説明	必須	デフォルト値
`APPD_USER`	スマートエージェントプロセスを実行するユーザー	×	`root`
`APPD_User_GROUP`	スマートエージェントプロセスを実行するグループ	×	`root`
`APPD_SMARTAGENT_PYTHON3`	スマートエージェントで使用される Python3 インタープリタ	×	`/opt/appdynamics/appdsmartagent/plugins/appdenv/bin/python3` インストールに `APPD_SMARTAGENT_PYTHON3` を指定すると、Python 3 バイナリを使用して `<smartagent-dir>/plugins/appdenv` に仮想環境が作成され、スマートエージェントに付属するデフォルトの Python インタープリタ（PyPy）が `<smartagent-dir>/plugins/appdenvbak` バックアップフォルダに移動されます。 Java またはマシンエージェントを管理するためにスマートエージェントをインストールする場合、これは必要ありません。

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

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

基本設定

基本設定は、スマートエージェントをコントローラに登録するために必要な設定です。基本的なスマートエージェントの設定の、次のパラメータを更新します。

ControllerURL：スマートエージェントとの接続を確立するコントローラの URL。
FMServicePort: スマートエージェントが FM サービス（エージェント管理）に接続するポート。オンプレミスコントローラの場合は 8030、SaaS コントローラの場合は 443。
AccountAccessKey：コントローラのアカウントアクセスキー。

AccountName：スマートエージェントがレポートするコントローラのアカウント名。

config.ini

ControllerURL    =
ControllerPort   = 443
FMServicePort  = 8030
AgentType        =
AccountAccessKey =
AccountName      = 
EnableSSL      = true

[CommonConfig]
ServiceName           =
ServiceNamespace      =
RequestTimeoutSeconds = 0
AgentName             =
PollingIntervalInSec  =

[OAuth]
OAuthID      =
OAuthSecret  =
AuthEndpoint =
TenantID     =
Scopes       =

[HTTPClientSettings]
Timeout = 0

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

[TLSSetting]
CAFile     =
CertFile   =
KeyFile    =
MinVersion = TLS 1.2
MaxVersion = TLS 1.3

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

[AnsibleConfig]
ExtraVars = create_appdynamics_user=false,add_ansible_install_env_var=false,check_pkg_dependencies=false,download_script=py
EnvVars = ANSIBLE_STDOUT_CALLBACK=appdynamics.agents.smartagent_callback
Verbose =

[Telemetry]
LogLevel=info
LogFile=
Profiling=false

YML

詳細設定

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

プロキシ設定

プロキシ設定を設定する必要がある場合は、config.ini ファイルの TLSClientSetting セクションで次のフィールドを指定します。

パラメータ	説明	例
AgentHTTPProxy	スマートエージェントの HTTP プロキシ URL を使用するには、このパラメータを指定します。	http://localhost:3128
AgentHTTPSProxy	スマートエージェントの HTTPS プロキシ URL を使用するには、このパラメータを指定します。	https://myhost:8443
AgentNoProxy	スマートエージェントのプロキシを使用する必要がない場合は、このパラメータを指定します。値は true または false です	false

次に、スマートエージェントの HTTP プロキシを使用する例を示します。

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

CODE

ログレベルの設定

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

debug
info
warn
error

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

[Telemetry]
LogLevel=info
LogFile=
Profiling=false

CODE

スマートエージェントプロセスの開始

スマートエージェントは、システムサービスとして管理されます。次のコマンドを使用して、スマートエージェントサービスを開始します。

Linux の場合、

$ [sudo]systemctl start smartagent.service

CODE

スマートエージェントサービスを再起動または停止するには、次のコマンドを使用します。

$ [sudo] systemctl {restart|stop} smartagent.service

CODE

Windows の場合

appdsmartagent-service.bat ファイルを実行すると、スマートエージェントサービスが起動します。コマンドラインインターフェイスを使用して次のコマンドを実行することもできます。

sc start appdsmartagent

CODE

サービスを停止するには、次のコマンドを使用します。

sc stop appdsmartagent

CODE

スマートエージェントのインストールの検証

次の手順を検証して、スマートエージェントのインストールが成功したことを確認します。

ホストマシンでスマートエージェントサービスのステータスを検証します。
コントローラ UI でスマートエージェントの登録ステータスを検証します。

ホスト上のスマートエージェントサービスのステータス

ホストマシンから次のコマンドを実行して、スマートエージェントサービスのステータスを確認します。

検証

$ [sudo] systemctl status smartagent.service

UI でのスマートエージェントの登録ステータスの検証

[Home] > [Agent Management ] > [ Manage Agents > Smart Agents
] の順に移動します。
スマートエージェントがインストールされているホストのスマートエージェントエントリがテーブルに表示されます。

スマートエージェントのインストール

Debian

Centos/RHEL

Linux zip

Windows

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

基本設定

詳細設定

プロキシ設定

ログレベルの設定

スマート エージェント プロセスの開始

Linux の場合、

Windows の場合

スマートエージェントのインストールの検証

ホスト上のスマート エージェント サービスのステータス

UI でのスマートエージェントの登録ステータスの検証

スマートエージェントプロセスの開始

ホスト上のスマートエージェントサービスのステータス