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

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

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

  1. ダウンロードポータルから zip ファイルを必要なホストマシンの任意の場所にダウンロードできます。
    $ unzip -d appdsmartagent appdsmartagent-<version>.zip
    CODE
  2. テキストエディタで config.ini ファイルを開き、プレースホルダの値を、接続する必要がある実際のアクセスキーとサービス URL に置き換えます。
    この情報は、スマートエージェントが目的のサービスと通信するために必要です。各設定オプションの説明については、「スマートエージェントの設定」を参照してください。
    $ cd appdsmartagent $ vim config.ini
    CODE

  3. smartagentctl を使用してスマートエージェントをインストールし、起動します。
    smartagentctl が含まれるディレクトリに移動し、必要なパラメータを使用して実行します。「インストールパラメータ」を参照してください。
    sudo ./smartagentctl start --enable-auto-attach --service --user <user> --group <group>
    CODE

    スマートエージェントをサービスとして実行するには、Sudo が必要です。

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


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

変数名説明必須デフォルト値
userスマート エージェント プロセスを実行するユーザー×
  • root
  • 管理者
groupスマート エージェント プロセスを実行するグループ×root


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

インストールパラメータ

次の表に、使用できるオプションのパラメータを示します。

パラメータ説明
--enable-auto-attach自動接続機能を有効にします。「アプリケーションへのエージェントの自動付加」を参照してください。
--userスマート エージェント プロセスのユーザー名を指定します。デフォルト値は現在のユーザーです。
値は文字列形式にする必要があります。
--group

スマート エージェント プロセスのグループを指定します。デフォルトは、現在の グループです。

値は文字列形式にする必要があります。

-h, --helpスマートエージェントの起動に関するヘルプを表示します。
--serviceスマートエージェントをサービスとしてインストールします。

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

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

次に、config.ini ファイルの例を示します。

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


基本設定


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


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

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

      config.ini

      ControllerURL = http://localhost ControllerPort = 8090 AgentType = AccountAccessKey = AccountName = [CommonConfig] ServiceName = ServiceNamespace = RequestTimeoutSeconds = 0 AgentName = PollingIntervalInSec = [OAuth] OAuthID = OAuthSecret = AuthEndpoint = TenantID = Scopes = [HTTPClientSettings] Timeout = 0 [TLSClientSetting] Insecure = false [TLSSetting] CAFile = CertFile = KeyFile =
      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

Telemetry

パラメータ説明
LogLevelinfo などのログレベル。
LogFileログファイルへのパス。
プロファイリングtrue を指定してプロファイリングを有効にします。

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

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

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

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

プロセスとしての起動

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

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

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

./smartagentctl start --user <username> --group <groupname>
CODE

実行可能な他の操作を表示するには、次のコマンドを実行します。

./smartagentctl --help
CODE

サービスとしての起動

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

Linux の場合、
$ sudo ./smartagentctl start --service
CODE

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

$ sudo ./smartagentctl stop
CODE
Windows の場合

スマート エージェント サービスは、管理者のコマンド ライン インターフェイスで \smartagentctl.exe ファイルを実行すると起動します。

.\smartagentctl.exe start --service
CODE

実行可能な他の操作を表示するには、次のコマンドを実行します。

.\smartagentctl.exe --help
CODE

たとえば、スマートエージェントを停止するには、次のコマンドを使用します。

.\smartagentctl.exe stop
CODE

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

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

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

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

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

検証

$ [sudo] systemctl status smartagent.service

Windows の場合は、[Services] に移動して、Appdsmartagent サービスが実行されているかどうかを確認します。

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

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