はじめに

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

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

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

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

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

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

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

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

Debian

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

これにより、スマートエージェントがデフォルトの場所 /opt/appdynamics/appdsmartagent にインストールされます。

Centos/RHEL

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

これにより、スマートエージェントがデフォルトの場所 /opt/appdynamics/appdsmartagent にインストールされます。

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

Linux zip

インストールファイルを実行するには、次のパッケージをインストールする必要 があります。

• jq
• bzip2
• pip3

任意の場所でスマートエージェント zip ファイルを解凍し、次のコマンドを実行します。

 ./install-script.sh 

これにより、スマートエージェントがプロセスとしてインストールされます。スマートエージェントをサービスとしてインストールするには、Sudo アクセスが必要です。

次のコマンドを実行して、スマートエージェントをサービスとしてインストールします。

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

Windows

1. Windows zip ファイルを任意の場所に解凍します。
2. 管理者としてコマンドラインを開きます。

3. 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 セクションで次のフィールドを指定します。

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

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

ログレベルの設定

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

• debug
•  info
• warn
• error

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

[Telemetry]
LogLevel=info
LogFile=
Profiling=false 

スマートエージェントの起動

スマートエージェントは、システムサービスまたはプロセスとして管理できます。

プロセスとしての起動

Linux の場合、Sudo アクセスなしでスマートエージェントをプロセスとして起動できます。

Windows の場合、スマートエージェントを起動するには管理者アクセス権が必要です。したがって、Windows のプロセスとしてスマートエージェントを開始することはできません。

スマートエージェントをプロセスとして起動するには、次のコマンドを実行します。

./smartagent

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

{restart|stop} smartagent.service  

サービスとしての起動

スマートエージェントをサービスとして起動するには、次のコマンドを実行します。

Linux の場合、

$ [sudo]systemctl start smartagent.service 

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

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

Windows の場合

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

sc start appdsmartagent

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

sc stop appdsmartagent

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

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

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

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

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

検証

$ [sudo] systemctl status smartagent.service

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

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