エージェントインストーラ

Deployment Support

エージェントインストーラには、AppDynamics によって実行されるマイクロサービスの構成が必要です。

AppDynamics エージェントインストーラによって展開を簡素化し、アプリケーションを迅速にインストゥルメント化します。エージェントインストーラでインストゥルメント化されたアプリケーションは、[Monitoring Settings].Agent Installer v21.9での最小限のコード変更で管理できます。

エージェントインストーラ：

Java エージェントおよびマシンエージェントを展開します。Linux と互換性があります。
アプリケーションの自動インストゥルメント化
ティアとノードへの一意の名前の割り当て

その他のエージェントは、開始ウィザードを使用して展開できます。

エージェントインストーラの概要

エージェントインストーラは、次の項目とともに動作します。

エージェントインストーラ：appdynamics-zero-agent-<version>.zip ファイル内の実行可能インストーラ（エージェントインストーラプラットフォームを表す）。エージェントインストーラは、Java およびマシンエージェントとともにエージェントインストーラプラットフォームをシステムにインストールします。コントローラ UI でインストーラにアクセスします。
デコレータ：AppDynamics APM エージェントを使用して新しいプロセスを自動的にインストゥルメント化するためのライブラリ。ライブラリは、アプリケーションを自動インストゥルメント化し、コントローラのティアとノードを自動で命名します。
エージェントインストーラプラットフォーム：デコレータ、Java エージェント、およびマシンエージェントを管理するソフトウェアバンドル。自動インストゥルメンテーションを有効化し、さまざまなプロセスのステータスをコントローラ UI に報告します。デコレータ、エージェント daemon、エージェントバイナリの総称です。
ダウンローダ：Java およびマシン（該当する場合）エージェント、およびエージェントインストーラプラットフォームを含む個々の zip ファイルをダウンロードするスクリプト（zero-agent.sh）。

エージェントインストーラの要件

エージェントインストーラには、次のコンポーネント、権限、およびサポートされている環境が必要です。

AppDynamics のコンポーネント

エージェントインストーラには、SaaS コントローラ 20.6.0 以降が必要です。
また、Java およびマシンエージェントを使用するために十分な数の APM ライセンスも必要です。エージェントインストーラプラットフォームに追加のライセンスは必要ありません。

ファイアウォールの設定とブロック解除

ファイアウォールルールを設定して、次を含む特定の URL への発信トラフィックを許可する必要が生じる場合があります。

AppDynamics コントローラへのアクセス：<customername>.saas.appdyanamics.com/* で APM トラフィックを許可します。
AppDynamics ダウンロードファイルサイトへのアクセス：download-files.appdynamics.com でエージェントバイナリをダウンロードします。

エージェントインストーラの権限

アクセスとロールを設定するには、AppDynamics アカウントの所有者であるか、管理者権限が必要です。また、Cloud Native Visualization には、AppDynamics SaaS プラットフォームの設定変更が必要です。2020 年 10 月 28 日に、SaaS コントローラへの設定の展開が開始されました。

エージェントインストーラを使用するには、Install Agent アカウントレベルの権限と、次のうちの少なくとも 1 つが必要です。

- 任意のデフォルトロール（Analytics Administrator ロールを除く）
- 任意のアプリケーションレベルの権限
- Execute Workflow アカウントレベルの権限

Install Agent 権限は、デフォルトロールには追加されていません。「Roles and Permissions」を参照してください。

対応環境

この表では、エージェントインストーラでサポートされている環境を示します。JVM およびアプリケーションサーバの要件は、Java エージェントをインストールする場合にのみ適用されます。エージェントインストーラは Windows のインストールをサポートしていません。

エージェントインストーラでサポートされる環境

オペレーティングシステム（Operating System）

Linux（64 ビット）。完全にテストされたフレーバー：

CentOS 7、8
Rhel 7、8
Ubuntu 18.04
Fedora 31
Debian 10

他の Linux オペレーティングシステムおよびバージョンはおそらく機能しますが、AppDynamics によって認定されていません。

JVM

Open => JDK 1.6
Oracle => JDK 1.7
IBM JDK => 1.6

アプリケーションサーバ

Apache Tomcat
Jboss Wildfly
GlassFish
WebSphere
Weblogic

バージョンの互換性については、「Java対応環境」と「マシンエージェントの要件とサポートされる環境」を参照してください。

エージェントとプロセスの制限

このテーブルには、アクティブなエージェント登録、プロセス、およびエージェントインストーラに対するプロセスグループの制限が一覧表示されます。

Agent（エージェント）	アカウントあたりの上限
アクティブなエージェントの登録数	1000
プロセス	アカウントあたりの上限
管理対象プロセス	10,000
管理対象外プロセス	10,000
単一のインストールでの管理対象プロセス	100
単一のインストールでの管理対象外プロセス	100
プロセスグループ	アカウントあたりの上限
管理対象プロセスグループ	1000
管理対象外プロセスグループ	1000
単一のインストールでの管理対象プロセスグループ	100
単一のインストールでの管理対象外プロセスグループ	100

エージェントインストーラで使用可能なエージェント

エージェントインストーラによってエージェントインストーラプラットフォームを展開し、モニタするエージェントをマシンにダウンロードします。次をインストールできます。

Java エージェント 4.5.19 以上
マシンエージェント 20.3.0 以上

エージェントインストーラを使用したエージェントの展開

エージェントインストーラを使用してエージェントを展開するには、次の手順を実行します。

コントローラ UI から、[Home] > [Agent Installer] を選択します。
[Specify Application to Deploy to] ドロップダウンから、既存のアプリケーションを選択するか、[New application] を選択して名前を入力します。

アプリケーション名に一重引用符（'）を含めることはできません。
エージェントインストーラをダウンロードして、高速インストールまたはカスタムインストールの方法を使用して実行します。

高速インストール方法

[Express installation] 方法がデフォルトとして選択されています。最小限の労力で、使用可能なすべてのエージェントの最新バージョンをダウンロードしてインストールできます。
最初のコマンドをコピーして実行し、使用可能な最新のエージェントをダウンロードします。
（2 番目のコマンドの右上隅）を選択してコピーし、2 番目のコマンドを実行してエージェントをインストールします。また、[Show command] を選択して、アクセスキーを使用して完全なコマンドを表示することもできます。
モニタするアプリケーションプロセスを再起動します。
[Next] をクリックして、インストゥルメンテーションを続けます。

エージェントのインストールが完了すると、[Monitoring Settings] タブにリダイレクトされ、インストゥルメント化された階層とノードが表示されます。

カスタムインストール方法

[Custom installation] を選択します。
インストールする Java または Machine Agent を選択します。

インストールを進めるには、少なくとも 1 つのエージェントを選択する必要があります。
選択したエージェントの横にデフォルトバージョンが表示されます。対応するドロップダウンからバージョンを編集できます。選択したエージェントに基づくコマンドが生成されます。
端末または自動ツールにコマンドをコピーして実行します。
ユーザ権限を設定して、エージェントインストーラの実行方法を決定します。
- sudo 権限でエージェントインストーラを実行し、ホスト上のすべてのユーザに対してエージェントインストーラプラットフォームを有効にするには、[ Instrument processes for all system users] を選択します（sudo アクセスが必要です）。
- sudo 権限なしでエージェントインストーラを実行し、現在のユーザに対してのみエージェントインストーラプラットフォームを有効にするには、[ Instrument processes for an individual user ] を選択します。
  詳細については、「Sudo と非 Sudo アクセスの比較」を参照してください。
ユーザのインストール権限を確認した後に、（コマンドの右上隅）を選択してコマンドをコピーし、実行します。アクセスキーを使用して完全なコマンドを表示するには、[Show command] を選択します。

指定されたホストでコマンドを実行すると、エージェントファイルはそのホストのみにダウンロードされます。複数のホストにエージェントをインストールするには、「複数のホストでのエージェントインストーラの実行」を選択します。
モニタするアプリケーションプロセスを再起動します。
[Next] をクリックして、インストゥルメンテーションを続けます。

エージェントのインストールが完了すると、[Monitoring Settings] タブにリダイレクトされ、インストゥルメント化された階層とノードが表示されます。

Sudo と非 Sudo アクセスの比較

エージェントインストーラは 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

BASH

プロファイルを更新したら、変更を有効にするために systemctl デーモンをリロードし、アプリケーションを再起動する必要があります。

$ sudo systemctl daemon-reload 
$ sudo systemctl restart apache-tomcat-7.service