Download PDF
Download page エージェントインストーラ.
エージェントインストーラ
Deployment Support
エージェントインストーラには、AppDynamics によって実行されるマイクロサービスの構成が必要です。
AppDynamics エージェントインストーラによって展開を簡素化し、アプリケーションを迅速にインストゥルメント化します。エージェントインストーラでインストゥルメント化されたアプリケーションは、[Monitoring Settings] での最小限のコード変更で管理できます。
エージェントインストーラ(Linux および Windows オペレーティングシステム)
Linuxの場合:
Java およびマシンエージェントの展開
- アプリケーションの自動インストゥルメント化
- ティアとノードへの一意の名前の割り当て
- エージェントのアップグレードとロールバック
Windowsの場合:
マシンエージェントの展開
その他のエージェントは、開始ウィザードを使用して展開できます。
エージェントインストーラの概要
エージェントインストーラは、以下の項目とともに動作します。
Linuxの場合:
- エージェントインストーラ:
appdynamics-zero-agent-<version>.zip
ファイル(エージェント インストーラ プラットフォームを表す)内の実行可能インストーラ。エージェントインストーラは、Java およびマシンエージェントとともにエージェント インストーラ プラットフォームをシステムにインストールします。コントローラ UI でインストーラにアクセスします。 - デコレータ:AppDynamics APM エージェントを使用して新しいプロセスを自動的にインストゥルメント化するためのライブラリ。ライブラリは、アプリケーションを自動インストゥルメント化し、コントローラのティアとノードを自動で命名します。
- エージェント インストーラ プラットフォーム:デコレータ、Java エージェント、およびマシンエージェントを管理するソフトウェアバンドル。自動インストゥルメンテーションを有効化し、さまざまなプロセスのステータスをコントローラ UI に報告します。デコレータ、エージェント
daemon
、エージェントバイナリの総称です。 - ダウンローダ:Java およびマシン(該当する場合)エージェント、およびエージェント インストーラ プラットフォームを含む個々の zip ファイルをダウンロードするスクリプト(
zero-agent.sh
)。 - ウォッチドッグ:エージェントインストーラでインストールされたエージェントは、W
atchdog
プロセスで管理できます。 - アップデータ:モニタリングエージェントのロールバックとアップグレードを行います。
Windowsの場合:
- エージェントインストーラ:
appdynamics-zero-agent-windows-64-<version>.zip
ファイル(エージェント インストーラ プラットフォームを表す)内の実行可能インストーラ。エージェントインストーラは、マシンエージェントとともにエージェント インストーラ プラットフォームをシステムにインストールします。コントローラ UI でインストーラにアクセスします。 - エージェント インストーラ プラットフォーム:マシンエージェントを管理するソフトウェアバンドル。メトリックをコントローラ UI に送信します。エージェント
daemon
、エージェントバイナリの総称です。 - ダウンローダ:マシンエージェント、およびエージェント インストーラ プラットフォームを含む個々の zip ファイルをダウンロードするスクリプト(
zero-agent.ps1
)。 - ウォッチドッグ:エージェントインストーラでインストールされたエージェントは、W
atchdog
プロセスで管理できます。 - アップデータ:モニタリングエージェントのロールバックとアップグレードを行います。
エージェントインストーラの要件
エージェントインストーラには、次のコンポーネント、権限、およびサポートされている環境が必要です。
AppDynamics のコンポーネント
- エージェントインストーラには、SaaS コントローラ 20.6.0 以降が必要です。
- また、Java およびマシンエージェントを使用するために十分な数の APM ライセンスも必要です。エージェント インストーラ プラットフォームに追加のライセンスは必要ありません。
ファイアウォールの設定とブロック解除
ファイアウォールルールを設定して、次を含む特定の URL への発信トラフィックを許可する必要が生じる場合があります 。
AppDynamics コントローラへのアクセス:
<customername>.saas.appdyanamics.com/*
で APM トラフィックを許可します。- AppDynamics ダウンロードファイルサイトへのアクセス:
accounts.appdynamics.com/downloads
でエージェントバイナリをダウンロードします。
エージェントインストーラの権限
アクセスとロールを設定するには、AppDynamics アカウントの所有者であるか、管理者権限が必要です。また、Cloud Native Visualization には、AppDynamics SaaS プラットフォームの設定変更が必要です。2020 年 10 月 28 日に、SaaS コントローラへの設定の展開が開始されました。
エージェントインストーラを使用するには、Install Agent アカウントレベルの権限と、次のうちの少なくとも 1 つが必要です。
- 任意のデフォルトロール(Analytics Administrator ロールを除く)
- 任意のアプリケーションレベルの権限
- Execute Workflow アカウントレベルの権限
Install Agent 権限は、デフォルトロールには追加されていません。
対応環境
この表では、エージェントインストーラでサポートされている環境を示します。JVM およびアプリケーションサーバの要件は、Java エージェントをインストールする場合にのみ適用されます。エージェントインストーラは Windows のインストールをサポートしていません。
エージェントインストーラでサポートされる環境 | |
---|---|
オペレーティング システム | Linux(64 ビット)。完全にテストされたフレーバー:
他の Linux オペレーティングシステムおよびバージョンはおそらく機能しますが、AppDynamics によって認定されていません。 Windows Server(64 ビット)。完全にテストされたフレーバー:
|
JVM (Linux のみ) |
|
アプリケーション サーバ (Linux のみ) |
|
バージョンの互換性については、「Java対応環境」と「マシンエージェントの要件とサポートされる環境」を参照してください。
エージェントとプロセスの制限
このテーブルには、アクティブなエージェント登録、プロセス、およびエージェントインストーラに対するプロセスグループの制限が一覧表示されます。
Agent(エージェント) | アカウントあたりの上限 |
---|---|
アクティブなエージェントの登録数 | 1000 |
プロセス | アカウントあたりの上限 |
管理対象プロセス | 10,000 |
管理対象外プロセス | 10,000 |
単一のインストールでの管理対象プロセス | 100 |
単一のインストールでの管理対象外プロセス | 100 |
プロセスグループ | アカウントあたりの上限 |
管理対象プロセスグループ | 1000 |
管理対象外プロセスグループ | 1000 |
単一のインストールでの管理対象プロセスグループ | 100 |
単一のインストールでの管理対象外プロセスグループ | 100 |
エージェントインストーラで使用可能なエージェント
エージェントインストーラによってエージェント インストーラ プラットフォームを展開し、モニタするエージェントをマシンにダウンロードします。次をインストールできます。
- 4.5.19 以降の Java エージェント(Linux のみ)
マシンエージェント 20.3.0 以上
エージェントインストーラを使用したエージェントの展開
エージェントインストーラを使用してエージェントを展開するには、次の手順を実行します。
- コントローラ UI から、[Home] > [Agent Installer] を選択します。
[Specify Application to Deploy to] ドロップダウンから、既存のアプリケーションを選択するか、[New application] を選択して名前を入力します。
アプリケーション名に一重引用符(')を含めることはできません。
- エージェントインストーラをダウンロードして、高速インストールまたはカスタムインストールの方法を使用して実行します。
詳細については、「エージェントインストーラ API を使用したエージェントの展開」を参照してください。
高速インストール方法
- [Express installation] 方法がデフォルトとして選択されています。最小限の労力で、使用可能なすべてのエージェントの最新バージョンをダウンロードしてインストールできます。
最初のコマンドをコピーして実行し、使用可能な最新のエージェントをダウンロードします。
(2 番目のコマンドの右上隅)を選択して 2 番目のコマンドをコピーして実行し、エージェントをインストールします。また、[Show command] を選択して、アクセスキーを使用して完全なコマンドを表示することもできます。
- モニタするアプリケーションプロセスを再起動します。
- [Next] をクリックして、インストゥルメンテーションを続けます。
エージェントのインストールが完了すると、[Monitoring Settings] タブにリダイレクトされ、インストゥルメント化された階層とノードが表示されます。
カスタムインストール方法
- [Custom installation] を選択します。
インストールする [Java Agent ](Linux のみ)、[Machine Agent]、またはその両方を選択します。
インストールを進めるには、少なくとも 1 つのエージェントを選択する必要があります。
選択したエージェントの横にデフォルトバージョンが表示されます。対応するドロップダウンからバージョンを編集できます。選択したエージェントに基づくコマンドが生成されます。
- ターミナル(Linux)/PowerShell(Windows)ウィンドウまたは自動化ツールにコマンドをコピーして実行します。
- ユーザー権限を設定して、エージェントインストーラの実行方法を決定します。
- Linuxの場合:
sudo
権限でエージェントインストーラを実行し、ホスト上のすべてのユーザーに対してエージェント インストーラ プラットフォームを有効にするには、[ Instrument processes for all system users] を選択します(sudo
アクセスが必要です)。sudo
権限なしでエージェントインストーラを実行し、現在のユーザーに対してのみエージェント インストーラ プラットフォームを有効にするには、[ Instrument processes for an individual user ] を選択します。
詳細については、「Sudo と非 Sudo アクセスの比較」を参照してください。
- Windowsの場合:
- デフォルトでインストールされるサービスは、
LOCAL SYSTEM
または限定された権限のアカウントです。ローカルサービスアカウントとして実行するようにサービスを設定するには、次のようにします。Windows アカウントの
run-as
およびpassword
パラメータを追加します。インストールプロセスは、使用する必要があるサービスアカウントを示すパラメータを受け取ります。インストーラサービスは、ローカルシステムアカウントではなく、指定された別のサービスアカウントでインストールする必要があります。
- サービスアカウントが使用される場合(
NT AUTHORITY\LOCAL SERVICE
など)、パスワードパラメータは指定されません。16 文字以上のパスワードを使用してください。
- デフォルトでインストールされるサービスは、
- Linuxの場合:
ユーザーのインストール権限を確認した後に、(コマンドの右上隅)を選択してコマンドをコピーし、実行します。アクセスキーを使用して完全なコマンドを表示するには、[Show command] を選択します。
指定されたホストでコマンドを実行すると、エージェントファイルはそのホストのみにダウンロードされます。複数のホストにエージェントをインストールするには、「複数のホストでのエージェントインストーラの実行」を選択します。
モニタするアプリケーションプロセスを再起動します。
- [Next] をクリックして、インストゥルメンテーションを続けます。
エージェントのインストールが完了すると、[Monitoring Settings] タブにリダイレクトされ、インストゥルメント化された階層とノードが表示されます。
Sudo と非 Sudo アクセスの比較(Linux)
エージェントインストーラは sudo
権限の有無にかかわらず実行できます。
AppDynamics は、sudo
コマンドを使用して、システム内のすべてのユーザーに対してエージェントをインストールすることを推奨します。
次の表では、sudo
と non-sudo
のインストールの違いについて説明します。
sudo のインストール | 非 sudo のインストール | |
---|---|---|
説明 | システム内のすべてのユーザに対して、サポートされているすべてのプロセスにエージェントをインストールします。 | 現在のユーザのみに対してエージェントをインストールします。 |
自動インストゥルメンテーション プロセス | デフォルトでは、systemd と統合して、エージェントが常に実行されるようにします。この動作をオーバーライドするには、「エージェントインストーラのカスタマイズ」を参照してください。 | インストールユーザーによって開始され、bash などの Linux シェルで実行されるプロセスを自動インストゥルメント化します。 |
非 sudo
環境での systemd
管理対象プロセスのインストゥルメント化
非 sudo
エージェント インストーラ プラットフォームのインストールで systemd
管理対象アプリケーションプロセスのインストゥルメンテーションを有効にするには、アプリケーションプロセスのロードに使用される systemd
サービスのプロファイルで、デコレータライブラリへのパスを使用して LD_PRELOAD
環境変数を定義する必要があります。
実際のパスは、オペレーティングシステムと製品のインストールディレクトリによって異なります。次に、CentOS 7 で更新された Apache Tomcat systemd
サービスプロファイルの例を示します。
$ grep LD_PRELOAD /etc/systemd/system/apache-tomcat-7.service Environment=LD_PRELOAD=/home/centos/appdynamics/zeroagent/lib64/libpreload.so
プロファイルを更新したら、変更を有効にするために systemctl
デーモンをリロードし、アプリケーションを再起動する必要があります。
$ sudo systemctl daemon-reload
$ sudo systemctl restart apache-tomcat-7.service
複数のホストでのエージェントインストーラの実行
エージェントインストーラは、一度ダウンロードすると複数のホストで実行できます。複数のホストにエージェントバンドルをインストールするには、該当するすべてのマシンにバイナリを配布します。
たとえば、次の手順は、tar
コマンドを使用してホスト間でファイルを移動する方法を示しています。
- エージェントバンドルをダウンロードします。「エージェントインストーラを使用したエージェントの展開」を参照してください。
- エージェントインストーラを複数のホストに配布します。
- エージェントバンドルをダウンロードしたディレクトリと同じディレクトリにいることを確認します。
tar
コマンドを使用して、スクリプトを 1 つのファイルに入れます。tar cvf zero-agent.tar *
BASHファイルを複数のホストにコピーします。
scp zero-agent.tar <target host>:<directory>
BASHアーカイブされたスクリプトを同じディレクトリに展開します。
tar xvf zero-agent.tar
BASH
- カスタムインストール方法を使用して、エージェントインストーラの展開を完了します。
エージェントインストーラのカスタマイズ
エージェントの構成を変更するには、「エージェントインストーラのカスタマイズ」を参照してください。
エージェントインストーラのアップグレードとロールバック(Linux と Windows)
Linuxの場合:
- 「エージェントのアップグレードとロールバック」を参照してください。
Windowsの場合:
- アップグレードは、手動でアンインストールしてから、新しいバージョンをインストールすることで実行されます。
エージェントインストーラのアンインストール
エージェントインストーラをアンインストールするには、端末で、エージェント インストーラ プラットフォームがインストールされているディレクトリに移動し、次のコマンドを実行します。
languagebash<install-directory>/bin/zfictl uninstall (on Linux)
<install-directory>\bin\zfictl.exe uninstall (on Windows)