Linux 上でネットワークエージェントをインストールする

重要事項

• Docker コンテナで実行されているアプリケーションをモニタするためにネットワークの可視性を使用している場合は、ネットワークエージェントもコンテナにインストールする必要があります。「Docker とネットワークの可視性」を参照してください
• インストールスクリプトを実行するには、root としてログインします。 
• その他のすべての操作については、そのホストの指定エージェント管理者（<appd-agent-administrator>）としてログインします。

1. システム要件を確認します。詳細については、ネットワークの可視性に対応した環境を参照してください。

2. エージェントインストーラをダウンロードして解凍します。

   

   ログインユーザ = エージェント管理者

   1. エージェントホストに <appd-agent-administrator> としてログインします。
   2. AppDynamics ダウンロードポータルにアクセスし、ネットワーク エージェント インストーラをダウンロードして解凍します。
   3. ターミナルウィンドウで、ネットワークエージェントの ZIP パッケージをダウンロードしたフォルダに cd を使用して移動します。

   4. 次のコマンドを入力します。ここで、<network_agent_home> はエージェントソフトウェアをインストールするフォルダです。
      unzip <installer.zip> -d <network_agent_home>

      親パスには、スペースを含むディレクトリ名を含めることはできません。

      /opt/appdynamics/networkVisibility （正しい）

      /opt/appdynamics/network visibility （誤り）

3. エージェントをインストールします。

   

   ログインユーザ = root

   1. ログアウトして、root としてログインします。
   2. <network_agent_home> に移動し、次のようにインストールスクリプトを実行します。
      cd <network-agent-home>
      ./install.sh

4. エージェントを起動して確認します。

   

   ログインユーザ = エージェント管理者

   1. ログアウトして、appd-agent-administrator としてログインします。
   2. CLI ウィンドウを開き、次のコマンドを入力します。
      1. <network-agent-home>/bin/start.sh （エージェントを起動します）
      2. <network-agent-home>/bin/appd-netviz.sh status （エージェントが実行されていること、およびエージェントプロセスの PID が表示されていることを確認します）
5. 問題や課題が発生した場合は、「ネットワークの可視性に関する FAQ」を参照してください。
6. 「Linux 上でネットワーク可視性を設定する」のワークフローの一部としてネットワークエージェントをインストールする場合は、「Linux 上でネットワークエージェントとアプリケーション エージェントを設定する」に進みます。

概要

Docker コンテナで実行されているアプリケーションをモニタするためにネットワークの可視性を使用している場合は、ネットワークエージェントもコンテナにインストールする必要があります。「Docker とネットワークの可視性」を参照してください

1. システム要件を確認します。詳細については、ネットワークの可視性に対応した環境を参照してください。
2. 非ルートユーザとしてエージェントホストにログインしている場合は、ログアウトしてから root として再度ログインします。
3. AppDynamics ダウンロードポータルにアクセスし、ネットワーク エージェント インストーラをダウンロードします。
4. ターミナルウィンドウを開き、次のコマンドを入力します。
   1. sudo rpm -ivh <installer.rpm> （エージェントを opt/appdynamics/netviz にインストールします）
   2. sudo service appd-netviz start （エージェントを起動します）
   3. sudo service appd-netviz status （エージェントが実行されていることを確認します）
5. 問題や課題が発生した場合は、「ネットワークの可視性に関する FAQ」を参照してください。
6. 「Linux 上でネットワーク可視性を設定する」のワークフローの一部としてネットワークエージェントをインストールする場合は、「Linux 上でネットワークエージェントとアプリケーション エージェントを設定する」に進みます

概要

Docker コンテナで実行されているアプリケーションをモニタするためにネットワークの可視性を使用している場合は、ネットワークエージェントもコンテナにインストールする必要があります。「+ Docker とネットワークの可視性」を参照してください

1. システム要件を確認します。詳細については、ネットワークの可視性に対応した環境を参照してください。
2. 非ルートユーザとしてエージェントホストにログインしている場合は、ログアウトしてから root として再度ログインします。
3. AppDynamics ダウンロードポータルにアクセスし、ネットワーク エージェント インストーラをダウンロードします。
4. ターミナルウィンドウを開き、次のコマンドを入力します。
   1. sudo dpkg -i <installer.deb> （エージェントを opt/appdynamics/netviz にインストールします）
      （エージェントを起動します。" appd-netviz start/running. process <pid #>" と出力されます）
   2. sudo service appd-netviz status （エージェントのステータスを確認します）
5. エージェントが起動しない場合は、 sudo service appd-netviz start と入力します。
6. 問題や課題が発生した場合は、「ネットワークの可視性に関する FAQ」を参照してください。
7. 「Linux 上でネットワーク可視性を設定する」のワークフローの一部としてネットワークエージェントをインストールする場合は、「Linux 上でネットワークエージェントとアプリケーション エージェントを設定する」に進みます

ネットワークエージェントが、同じホスト上の Docker コンテナで実行されているアプリケーションをモニタできます。ホストごとに 1 つのネットワークエージェントを展開し、コンテナ内の Java アプリケーション エージェントによってモニタされるローカルアプリケーションごとに個別のメトリックを収集できます。

AppDynamics では、アプリケーションコンテナと同じホスト上の Docker ホストネットワークモードの別のコンテナにネットワークエージェントをインストールすることを推奨しています。この推奨事項は、アプリケーション エージェント コンテナが Docker ブリッジまたは Docker ホストモードで実行されている場合に適用されます。  

ネットワークエージェントとアプリケーション エージェントのインストール

1. サンプル Dockerfile をテキストファイルに貼り付けて、ファイルを保存します。このサンプル Dockerfile には、ネットワークエージェントをインストールするためのコマンドが含まれています。

   FROM centos:centos7
   
   RUN yum update -y && yum install -y \
     net-tools \
     iproute \
     tcpdump \
     curl  \
     unzip   \
     sysvinit-tools \
     openssh-clients
   
   WORKDIR /netviz-agent
   
   ARG NETVIZ_ZIP_PKG
   
   # copy NetViz agent contents
   ADD ${NETVIZ_ZIP_PKG} .
   
   # run the agent install script
   RUN unzip *.zip && ./install.sh \
       && sed -i -e "s|enable_netlib = 1|enable_netlib = 0|g" ./conf/agent_config.lua \
       && sed -i -e "s|WEBSERVICE_IP=.*|WEBSERVICE_IP=\"0.0.0.0\"|g" ./conf/agent_config.lua
   
   # default command to run for the agent
   CMD  ./bin/appd-netagent -c ./conf -l ./logs -r ./run

   CODE

2. Dockerfile を保存したディレクトリに移動します。次のように入力して、Docker イメージを作成します。

   docker build --build-arg NETVIZ_ZIP_PKG=/path/to/netviz-agent-pkg.zip -t appd-netviz .

   CODE

3. Docker の信頼できるレジストリに Docker イメージをプッシュします。

4. このサンプル Docker 構成ファイルを使用して、Docker イメージを展開します。
   

   version: '2'
   services:
     appd-netviz-agent:
       image: path/to/your/docker/image # docker registry image
       network_mode: "host"
       restart: unless-stopped 
       ports:
         - '3892:3892'
       cap_add:
         - NET_ADMIN
         - NET_RAW

   CODE

   または、次のように入力します。
   

   docker run -d --network=host --cap-add=NET_ADMIN --cap-add=NET_RAW path/to/your/netviz/docker/image

   CODE

    

5. ネットワークエージェントを設定します。「Linux 上でネットワークエージェントとアプリケーション エージェントを設定する」のシングルテナント設定の手順に従います。

   

   シングルテナント設定の場合、netlib を有効にする必要はありません。

アプリケーション エージェントで Docker ホストゲートウェイ IP を指定する

Docker のホストネットワークの外部にある Docker コンテナでアプリケーション エージェントを実行している場合（図の例 1 を参照）、次の手順を実行します。

1. アプリケーション エージェントのホストで、次の環境変数を入力します。

   export APPDYNAMICS_NETVIZ_AGENT_HOST=$(ip -4 addr show docker0 | grep -Po 'inet \K[\d.]+')
   export APPDYNAMICS_NETVIZ_AGENT_PORT=3892

   CODE

2. ポートおよびホストアドレスの値を設定します。手順 1 でエクスポートした AppDynamics 環境変数を渡すことによって、アプリケーションの Docker イメージを実行します。例：

   docker run --env "APPDYNAMICS_NETVIZ_AGENT_HOST=$APPDYNAMICS_NETVIZ_AGENT_HOST"
   --env "APPDYNAMICS_NETVIZ_AGENT_PORT=$APPDYNAMICS_NETVIZ_AGENT_PORT" <application_docker_image>

   CODE

重要事項

• Docker コンテナで実行されているアプリケーションをモニタするためにネットワークの可視性を使用している場合は、ネットワークエージェントもコンテナにインストールする必要があります。「+ Docker とネットワークの可視性」を参照してください
• インストールスクリプトを実行するには、root としてログインします。 
• その他のすべての操作については、そのホストの指定エージェント管理者（<appd-agent-administrator>）としてログインします。

1. システム要件を確認します。詳細については、ネットワークの可視性に対応した環境を参照してください。

2. 次の手順を実行して、マシンエージェントをダウンロードして解凍します。

   

   ログインユーザ = エージェント管理者

   1. エージェントホストに <appd-agent-administrator> としてログインします。
   2. AppDynamics ダウンロードポータルにアクセスし、マシン エージェント インストーラをダウンロードして解凍します。
   3. 「JRE がバンドルされている ZIP を使用した Linux へのインストール」ページの説明に従って、Linux ZIP インストーラを使用してマシンエージェントをインストールします。 

3. 次の手順を実行して、マシンエージェントおよびネットワークの可視性拡張機能をインストールします。

   

   ログインユーザ = root

   1. ログアウトしてから、root としてログインします。
   2. CLI ウィンドウを開き、次のように入力します。
      
      1. cd <machine-agent-home>/extensions/NetVizExtension
      2. ./install-extension.sh


4. ネットワークの可視性拡張機能を有効にして、エージェントを起動します。

   

   ログインユーザ = エージェント管理者

   1. ログアウトしてから <appd-agent-administrator> としてログインします。
   2. 次の CLI コマンドを入力します。
      1. <machine-agent-home>/bin/machine-agent -d -p <machine-agent-home>/pidfile （マシンエージェントを起動します）
5. 問題や課題が発生した場合は、「ネットワークの可視性に関する FAQ」を参照してください。
6. 「Linux 上でネットワーク可視性を設定する」のワークフローの一部としてネットワークエージェントをインストールする場合は、「Linux 上でネットワークエージェントとアプリケーション エージェントを設定する」に進みます。