Download PDF
Download page スマートエージェントのコマンド ライン ユーティリティ.
スマートエージェントのコマンド ライン ユーティリティ
Splunk AppDynamics スマートエージェントのコマンド ライン ユーティリティ(CLI)は、リモートまたはローカルホスト上のノードを管理できるスタンドアロンサービスです。スマートエージェント CLI を個別にインストールして、サポートされているエージェントを管理できます。このユーティリティは、ビルドタイムワークフローで役立ちます。
サポートされるプラットフォーム
スマートエージェントのコマンド ライン ユーティリティは、次のいずれかのプラットフォームで使用できます。
- Alpine Linux
- RedHat ベースの Linux
- DebianベースのLinux
スマートエージェント CLI のインストール
スマートエージェント CLI は、任意のホストマシンにインストールできます。ダウンロードポータルから必要なホストマシンにそれぞれのファイルをダウンロードし、次の手順を実行します。
- 任意の場所でファイルを解凍します。
- 次のコマンドを実行して、同じ場所にスマートエージェント CLI をインストールします。
sudo [env [APPD_USER=<root-user>] [APPD_GROUP=<root-group>] ./install-script.sh
CODE
コマンド ライン ユーティリティ
次に、スマートエージェント CLI を使用してエージェント操作を実行するために使用できるコマンドの構文を示します。
appd { operation } { agent } --{ options }
この構文は、APM エージェントとスマートエージェントに使用できます。
APM エージェント
アプリケーション サーバー エージェントとマシンエージェントを管理するために、スマートエージェント CLI ユーティリティの CLI コマンドで使用できるサポートされている値は次のとおりです。
パラメータ | 値 | 詳細 |
---|---|---|
動作 |
| CLI コマンドを使用して、インストール、アップグレード、ロールバック、およびアンインストール操作を実行できます。 |
使用する |
| これらは、CLI コマンドを使用して操作を実行できる、サポートされているエージェントです。 |
オプション | エージェントオプション
| これらは、APM エージェントの操作に使用可能なフラグオプションです。フラグオプションは次のように分類されます。
|
接続オプション
| ||
インストール オプション
| ||
設定オプション
|
例:Java エージェント 23.9.0 をインストールするには、スマートエージェント CLI で次のコマンドを実行します。
appd install java --version 23.9.0
スマートエージェント 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) 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 コマンドで使用できるサポートされている値は次のとおりです。
引き数 | 値 | 詳細 |
---|---|---|
動作 |
| CLI コマンドを使用して、インストール、アップグレード、ロールバック、およびアンインストール操作を実行できます。 |
使用する |
| CLI コマンドを使用して操作を実行できるスマートエージェント。 |
オプション | エージェントオプション
| これらは、APM エージェントの操作に使用可能なフラグオプションです。フラグオプションは次のように分類されます。
|
ダウンロードオプション
| ||
接続オプション
| ||
インストール オプション
| ||
設定オプション
| ||
Smartagent オプション
|
次に例を示します。
appd install smartagent --install-agent-from {path_to_local_artifact} --auto-start
スマートエージェント 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
カスタム設定を使用したローカルマシンまたはコンテナへの 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
hosts ファイルの複数のホストへのマシンエージェントのインストール
次のコマンドを実行すると、1 つのコマンドで任意の数のホストにエージェントを一括インストールできます。
appd install machine -c /tmp/config.ini --inventory ./hosts --connection ssh --app-name demo-machine-app
ホストマシンへのスマートエージェントのインストール
スマートエージェントがホストマシンにインストールされると、smartagent
サービスが自動起動し、フラグによって制御されます。スマートエージェントを複数のホストにオンボーディングできます。
appd install smartagent --install-agent-from /vagrant/appdsmartagent_23.10.0-964_amd64.deb -c ./config.ini -i ./hosts -q ssh --auto-start