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

Deployment Support

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

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

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

• 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 アカウントの所有者であるか、管理者権限が必要です。

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

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

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

対応環境

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

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

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

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

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

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

• Java エージェント 4.5.19 以上

• マシンエージェント 20.3.0 以上

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

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

1. コントローラ UI から、[Home] > [Agent Installer] を選択します。

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

   

   アプリケーション名に一重引用符（'）を含めることはできません。

3. エージェントインストーラをダウンロードして、高速インストールまたはカスタムインストールの方法を使用して実行します。

高速インストール方法

1. [Express installation] 方法がデフォルトとして選択されています。最小限の労力で、使用可能なすべてのエージェントの最新バージョンをダウンロードしてインストールできます。  

2. 最初のコマンドをコピーして実行し、使用可能な最新のエージェントをダウンロードします。  

3. （2 番目のコマンドの右上隅）を選択してコピーし、2 番目のコマンドを実行してエージェントをインストールします。また、[Show command] を選択して、アクセスキーを使用して完全なコマンドを表示することもできます。

4. モニタするアプリケーションプロセスを再起動します。 
5. [Next] をクリックして、インストゥルメンテーションを続けます。 

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

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

1. [Custom installation] を選択します。 

2. インストールする Java  または Machine Agent を選択します。 

   

   インストールを進めるには、少なくとも 1 つのエージェントを選択する必要があります。

3. 選択したエージェントの横にデフォルトバージョンが表示されます。対応するドロップダウンからバージョンを編集できます。選択したエージェントに基づくコマンドが生成されます。 

4. 端末または自動ツールにコマンドをコピーして実行します。 
5. ユーザ権限を設定して、エージェントインストーラの実行方法を決定します。
   

   • sudo 権限でエージェントインストーラを実行し、ホスト上のすべてのユーザに対してエージェント インストーラ プラットフォームを有効にするには、[ Instrument processes for all system users] を選択します（sudo アクセスが必要です）。

   • sudo 権限なしでエージェントインストーラを実行し、現在のユーザに対してのみエージェント インストーラ プラットフォームを有効にするには、[ Instrument processes for an individual user ] を選択します。
     詳細については、「Sudo と非 Sudo アクセスの比較」を参照してください。 

6. ユーザのインストール権限を確認した後に、（コマンドの右上隅）を選択してコマンドをコピーし、実行します。アクセスキーを使用して完全なコマンドを表示するには、[Show command] を選択します。

   

   指定されたホストでコマンドを実行すると、エージェントファイルはそのホストのみにダウンロードされます。複数のホストにエージェントをインストールするには、「複数のホストでのエージェントインストーラの実行」を選択します。

7. モニタするアプリケーションプロセスを再起動します。 

8. [Next] をクリックして、インストゥルメンテーションを続けます。

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

Sudo と非 Sudo アクセスの比較

エージェントインストーラは sudo 権限の有無にかかわらず実行できます。

AppDynamics は、sudo コマンドを使用して、システム内のすべてのユーザに対してエージェントをインストールすることを推奨します。 

次の表では、sudo と non-sudo のインストールの違いについて説明します。

非 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 コマンドを使用してホスト間でファイルを移動する方法を示しています。 

1. エージェントバンドルをダウンロードします（「エージェントインストーラを使用したエージェントの展開」を参照）。 
2. エージェントインストーラを複数のホストに配布します。 
   1. エージェントバンドルをダウンロードしたディレクトリと同じディレクトリにいることを確認します。 

   2. 次の tar コマンドを使用して、スクリプトを 1 つのファイルに入れます。

      tar cvf zero-agent.tar * 

      BASH

   3. ファイルを複数のホストにコピーします。

      scp zero-agent.tar <target host>:<directory>

      BASH

   4. アーカイブされたスクリプトを同じディレクトリに展開します。

      tar xvf zero-agent.tar

      BASH
3. カスタムインストール方法を使用して、エージェントインストーラの展開を完了します。

エージェントインストーラのアップグレード

21.9.0 より前のバージョンでは、（エージェントインストーラを介して実行される）Java およびマシンエージェントをアップグレードする前に、現在のエージェントをアンインストールする必要があります。端末で、エージェント インストーラ プラットフォームがインストールされているディレクトリに移動し、次のコマンドを実行します。

languagebash<install-directory>/bin/zeroctl uninstall

エージェントインストーラのカスタマイズ

エージェントの構成を変更するには、「エージェントインストーラのカスタマイズ」を参照してください。