Splunk AppDynamics スマートエージェントのコマンド ライン ユーティリティ（CLI）は、リモートまたはローカルホスト上のノードを管理できるスタンドアロンサービスです。スマートエージェント CLI を個別にインストールして、サポートされているエージェントを管理できます。このユーティリティは、ビルドタイムワークフローで役立ちます。

スマートエージェント CLI はデータベースエージェントをサポートしていません。

サポートされるプラットフォーム

スマートエージェントのコマンド ライン ユーティリティは、次のいずれかのプラットフォームで使用できます。

  • Alpine Linux
  • DebianベースのLinux
  • RedHat ベースの Linux

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

スマートエージェント CLI は、任意のホストマシンにインストールできます。ダウンロードポータルから必要なホストマシンにそれぞれのファイルを独自にダウンロードし、ダウンロードしたファイルに基づいて次のコマンドを実行します。

APK

次のコマンドを実行します。

apk add --allow-untrusted --no-cache ./appdsmartagent-cli_<version>.apk
CODE

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

RPM

次のコマンドを実行します。

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

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

Debian

次のコマンドを実行します。

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

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

Linux zip

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

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

コマンド ライン ユーティリティ

次に、スマートエージェント CLI を使用してエージェント操作を実行するために使用できるコマンドの構文を示します。

appd { operation } { agent } --{ options }
BASH

この構文は、APM エージェントとスマートエージェントに使用できます。

APM エージェント

アプリケーション サーバー エージェントとマシンエージェントを管理するために、スマートエージェント CLI ユーティリティの CLI コマンドで使用できるサポートされている値は次のとおりです。

パラメータ値詳細
動作
  • install
  • upgrade
  • rollback
  • uninstall
CLI コマンドを使用して、インストール、アップグレード、ロールバック、およびアンインストール操作を実行できます。
使用する
  • java
  • machine
  • node
  • python
  • php
  • db
  • apache
  • iib
  • dotnet_msi
これらは、CLI コマンドを使用して操作を実行できる、サポートされているエージェントです。
オプション

Agent options

  • --version
  • --app-name
  • --node-name
  • --tier-name
  • --backup

これらは、APM エージェントの操作に使用可能なフラグオプションです。フラグオプションは次のように分類されます。

  • エージェントオプション
  • 接続オプション
  • インストール オプション
  • 設定オプション

Connection options

  • --inventory
  • --connection

Install options

  • --install-dir
  • --install-agent-from

Config options

  • --config
  • --profile

例：Java エージェント 23.9.0 をインストールするには、スマートエージェント CLI で次のコマンドを実行します。

appd install java --version 23.9.0
CODE

Smart Agent CLI Option-Operation Grid

操作次のいずれかのモードで 次アンインストールロールバック
フラグオプション

version 文字列（最新）（-v）

profile 文字列（デフォルト）（-p）

config 文字列（-c）

install-dir 文字列（-d）

app-name 文字列（-a）

node-name 文字列（-n）

tier-name 文字列（-t）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

instal-agent-from 文字列（-l）

version 文字列（最新）（-v）

profile 文字列（デフォルト）（-p）

config 文字列（-c）

install-dir 文字列（-d）

app-name 文字列（-a）

node-name 文字列（-n）

tier-name 文字列（-t）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

instal-agent-from 文字列（-l）

backup ブール（-b）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

スマートエージェント

スマートエージェントを管理するために、スマートエージェント CLI ユーティリティの CLI コマンドで使用できるサポートされている値は次のとおりです。

引き数値詳細
動作
  • install
  • upgrade
  • configure
  • uninstall
CLI コマンドを使用して、インストール、アップグレード、ロールバック、およびアンインストール操作を実行できます。
使用する
  • smartagent
CLI コマンドを使用して操作を実行できるスマートエージェント。
オプション

Agent options

--version

これらは、APM エージェントの操作に使用可能なフラグオプションです。フラグオプションは次のように分類されます。

  • エージェントオプション
  • ダウンロードオプション
  • 接続オプション
  • インストール オプション
  • 設定オプション
  • スマート エージェント オプション

Download options

--smartagent-download-url

--install-agent-from

Connection options

  • --inventory
  • --connection

Install options

  • --install-dir

Config options

  • --config
  • --profile

Smartagent options

  • smartagent-download-url
  • --auto-start
  • --attach-configure-file

次に例を示します。

appd install smartagent --install-agent-from {path_to_local_artifact} --auto-start
CODE

スマートエージェント CLI オプション操作表


操作次のいずれかのモードで 次アンインストールクラウド接続の
フラグオプション

version 文字列（最新）（-v）

profile 文字列（デフォルト）（-p）

config 文字列（-c）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

instal-agent-from 文字列（-l）

version 文字列（最新）（-v）

profile 文字列（デフォルト）（-p）

config 文字列（-c）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

instal-agent-from 文字列（-l）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

attach-configure-file 文字列（-f）


スマートエージェント CLI ユーティリティ フラグ オプションのデフォルト値

オプションデフォルト値

version 文字列（最新）（-v）

profile 文字列（デフォルト）（-p）

config 文字列（-c）

install-dir 文字列（-d）

app-name 文字列（-a）

node-name 文字列（-n）

tier-name 文字列（-t）

inventory 文字列（-i）

connection 文字列（-q）

hosts 文字列（-m）

install-agent-from 文字列（-l）

backup 文字列（-l）

attach-configure-file 文字列（-f）

latest

デフォルト

/opt/appdynamics/appdcli/config.ini

""

""

""

""

""

ローカル（local）

all

""

false

""

シナリオ例

次のセクションでは、シナリオで使用できるコマンドを使用したシナリオの例を示します。

デフォルト値を使用したローカルマシンへの Java のインストール

appd install java
CODE

カスタム設定を使用したローカルマシンまたはコンテナへの Java、ノード、およびマシンエージェントのインストール

Dockerfile、Terraform スクリプト、または CI/CD スクリプト（マシンのローカルアーティファクト）に次のコマンドを追加できます。

appd install java --config /tmp/config.ini --app-name demo-java-app --tier-name demo-java-tier
appd install node -c /tmp/config.ini --app-name demo-node-app --node-name demo-node-name
appd install machine -c /tmp/config.ini --app-name demo-machine-app --install-agent-from /vagrant/appdynamics-machine-agent-23.9.10.zip
CODE

ここで、config.ini はスマートエージェント CLI 構成ファイルです。

hosts ファイルの複数のホストへのマシンエージェントのインストール

次のコマンドを実行すると、1 つのコマンドで任意の数のホストにエージェントを一括インストールできます。

appd install machine -c /tmp/config.ini --inventory ./hosts --connection ssh --app-name demo-machine-app
CODE

ここで、config.ini はスマートエージェント CLI 構成ファイルです。

ホストマシンへのスマートエージェントのインストール

スマートエージェントがホストマシンにインストールされると、smartagent サービスが自動起動し、フラグによって制御されます。スマートエージェントを複数のホストにオンボーディングできます。

appd install smartagent --install-agent-from /vagrant/appdsmartagent_23.10.0-964_amd64.deb -c ./config.ini -i ./hosts -q ssh --auto-start
CODE

ここで、config.ini はスマートエージェント CLI 構成ファイルです。