ネットワークエージェント 4.5.7 および Java エージェント 4.5.11 では、同じマシン上で複数のノードを実行するときに、マルチテナントセットアップでネットワークエージェントを個別に設定する必要がなくなります。Java エージェント 4.5.10 以前でネットワークエージェント 4.5.7 を使用する場合は、マルチテナントセットアップでネットワークエージェントを設定する必要があります。「ネットワークエージェントと Java エージェントのインストール手順」を参照してください。

Network Agent and Java Agent Installation Instructions

次を使用している場合
次に
ネットワークエージェント 4.5.7 以降、Java エージェント 4.5.11 以降ネットワークエージェントをインストールします。
ネットワークエージェント 4.5.7 以降、Java エージェント 4.5.10 以前

ネットワークエージェントをマルチテナントセットアップまたはシングル テナント セットアップにインストールします。

マルチテナントセットアップ中に netlib パラメータを手動で有効にする必要はありません。デフォルトで有効になっています。

ネットワークエージェント 4.5.6 以前

ネットワークエージェントをマルチテナントセットアップまたはシングル テナント セットアップにインストールします。

マルチテナントセットアップ中に netlib パラメータを手動で有効にする必要があります。

Java アプリケーション エージェント 4.4 以前Java エージェントを更新します。

ネットワークエージェントのインストール

Java エージェント 4.5.13 以降を使用している場合は、手動でソケット収集を有効にする必要はありません。自動的に有効になります。手順 1 をスキップして、手順 2 に進むことができます。

アプリケーション エージェントでソケット収集を有効にする
  1. 次の例に示すように、Java アプリケーション エージェント開始コマンドを設定して、次のタスクを実行します。
    • ネットワークエージェントの appdynamics.socket.collection.bci.enable を有効にして、ネットワークメトリックをアプリケーションフローにマップします。
      次に例を示します。
       java -javaagent:<app_server_agent_home>/javaagent.jar \
       -Dappdynamics.socket.collection.bci.enable=true

  2. 次の例では、モニタ対象アプリケーションのフレームワークによって、エージェント開始コマンドの編集方法がどのように異なるかを示しています。「Javaフレームワークによるエージェントのインストール」および関連するフレームワークのドキュメントを参照してください。

    フレームワーク例（アプリケーション エージェント ZIP）
    IBM WebSphere および InfoSphere

    WebSphere/InfoSphere UI で、モニタ対象サーバの Java 仮想マシンのプロパティページに移動します。次に、javaagent と appdynamics.socket.collection.bci.enable=true を汎用 JVM 引数として追加します。例：

    javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true
    Apache Tomcat

    ファイル CATALINA_BASE/bin/setenv.sh（Tomcat 6 以降）で、完全なコマンドを Catalina 環境変数として追加します。例：

    export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true"
    Glassfish

    完全なコマンドを GlassFish ドメインの -javaagent JVM オプションとして追加します。asadmin ツールを使用してエージェントを追加できます。例： 

    export LD_PRELOAD=/usr/appd/agents/netviz/lib/appd-netlib.so
    glassfish4\bin\asadmin create-jvm-options "-
    javaagent\:/usr/appd/agents/apm/javaagent.jar:-Dappdynamics.socket.collection.bci.enable=true"
    JBoss スタンドアロン

    standalone.sh ファイルに完全なコマンドを追加します。例：

    export JAVA_OPTS="$JAVA_OPTS -javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true"

    Jetty

    Jetty ベースディレクトリの start.ini コンフィギュレーション ファイルに完全なコマンドを追加します。次に例を示します。

    --exec -javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true
  3. アプリケーション エージェントが正しく稼働していることを検証するには、次のコマンドを入力します。
    strings /proc/<app_pid>/environ
アプリケーション エージェントで Docker ホストゲートウェイ IP を指定します。

これらの手順は、アプリケーション エージェントが Docker ホストネットワーク外の Docker コンテナで実行されている場合にのみ必要です。

  1. 次のファイルを開きます。<app-agent-install-dir>/<version-number>/external-services/netviz/netviz-service.properties
    （このファイルにアクセスするために external-services/netviz.zip の解凍が必要になる場合があります）
  2. netviz.agent.host.address の場合、Docker ホスト ネットワーク インターフェイスのゲートウェイ IP を指定します。
    この IP を判別するには、Docker ホストで次のコマンドを入力します。
    docker inspect <app_container_name> | grep Gateway 
  3. アプリケーション エージェントを再起動します。 
  4. Docker ホストネットワークが接続されているかどうかを確認するには、コンテナ内から次のコマンドを入力します。
     curl -k -v <host-network-IP>:3892
    応答を受信した場合は、404 Not Found であっても、ネットワークが接続されます。
アプリケーションの再起動（IBM JVM のみ）

モニタリング対象のアプリケーションが IBM JVM で実行されている場合は、ネットワークエージェントが永続的な接続を検出してモニターするために、アプリケーションを再起動する必要があります。


マルチテナントのセットアップ（エージェントホスト上の複数のアプリケーション）

ネットワークエージェントが同じホスト上の複数のアプリケーションノードをモニタするようにするには、アプリケーション エージェントごとに次の手順を実行します。

ネットワークエージェント 4.5.6 以前を使用している場合は、ステップ 1 で説明されているように netlib パラメータを手動で有効にします。


ネットワークエージェントでの Netlib の有効化

  1. 次のファイルをテキストエディタで開きます。<network_agent_home>/conf/agent_config.lua
  2. enable_netlib パラメータを編集します。
    npm_config = {
          log_destination = "file",
          log_file = "agent.log",
          debug_log_file = "agent-debug.log",
          disable_filter = 1,
          mode = "Advanced",
          enable_netlib = 1,
          lua_scripts_path = ROOT_DIR .. "/scripts/netagent/lua/",
    } 
アプリケーション エージェントのインストールまたは更新（必要に応じて）

ネットワークエージェントには、Java アプリケーション サーバ エージェント 4.4 以降が必要です。以前のバージョンを実行している各アプリケーション エージェントを更新します。次を参照してください。Install the Java Agent

アプリケーション エージェントでの NetViz 外部サービスフォルダの抽出
  1. 次のフォルダに移動します。<app-agent-install-dir>/<version-number>/external-services
  2. まだ抽出されていない場合は、ZIP の内容が次のフォルダの下に配置されるように netviz.zip アーカイブを抽出します。
        <app-agent-install-dir>/<version-number>/external-services
NetLib をプリロードしてアプリケーション エージェントでソケット収集を有効にする
  1. 次の例に示すように、Java アプリケーション エージェント開始コマンドを設定して、2 つの追加タスクを実行する必要があります。
    • ネットワークエージェントが（ホスト全体ではなく）個々のノードのネットワークメトリックを収集できるように、appd-netlib ライブラリをプリロードします。
    • ネットワークエージェントの appdynamics.socket.collection.bci.enable を有効にして、ネットワークメトリックをアプリケーションフローにマップします。
      例：
      LD_PRELOAD=/<network-agent-home>/lib/appd-netlib.so \
       java -javaagent:<app_server_agent_home>/javaagent.jar \
       -Dappdynamics.socket.collection.bci.enable=true

次の例では、モニタ対象アプリケーションのフレームワークによって、エージェント開始コマンドの編集方法がどのように異なるかを示しています。「Javaフレームワークによるエージェントのインストール」および関連するフレームワークのドキュメントを参照してください。

フレームワーク例（アプリケーション エージェント ZIP）
IBM WebSphere および InfoSphere

WebSphere/InfoSphere UI で、モニタ対象サーバの Java 仮想マシンのプロパティページに移動します。次に、javaagent と appdynamics.socket.collection.bci.enable=true を汎用 JVM 引数として追加します。例：

javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true

JVM 環境変数として LD_PRELOAD を追加できます。次の例では、IBM Connections 6.0.0 を使用して、Cognos サーバに環境変数を追加する方法について説明します。

    1. Cognos サーバの WebSphere Application Server 管理コンソールにログインします。
    2. [Servers] > [Server Types] > [WebSphere application servers] をクリックします。
    3. [cognos_server] リンクをクリックします。
    4. [JAVA] > [Process Management] > [Process definition] > [Environment Entries ] > [New] をクリックして、次のエントリを追加します。
      LD_PRELOAD=/usr/appd/agents/netviz/lib/appd-netlib.so
  1. WebSphere/InfoSphere UI で、モニタ対象サーバの Java 仮想マシンのプロパティページに移動します。
  2. javaagent と appdynamics.socket.collection.bci.enable=true を汎用 JVM 引数として追加します。次に例を示します。

javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true

システム環境変数として LD_PRELOAD を追加できます。次の例では、IBM Connections 6.0.0 を使用して、Cognos サーバに環境変数を追加する方法について説明します。

  1. Cognos サーバの WebSphere Application Server 管理コンソールにログインします。
  2. [Servers ] > [Server Types] > [WebSphere Application Servers] に移動します。
  3. [cognos_server] をクリックします。
  4. [Java] > [Process Management] > [Process Definition] > [Environment Entries ] > [New] に移動して、次のエントリを追加します。
    LD_PRELOAD=/usr/appd/agents/netviz/lib/appd-netlib.so
Apache Tomcat

ファイル CATALINA_BASE/bin/setenv.sh（Tomcat 6 以降）で、完全なコマンドを Catalina 環境変数として追加します。例：

export LD_PRELOAD=/<network-agent-home-directory>/lib/appd-netlib.so

export CATALINA_OPTS="$CATALINA_OPTS -javaagent:/<java-agent-home-directory>/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true"

Glassfish

完全なコマンドを GlassFish ドメインの -javaagent JVM オプションとして追加します。asadmin ツールを使用してエージェントを追加できます。例： 

export LD_PRELOAD=/<network-agent-home-directory>/lib/appd-netlib.so

glassfish4\bin\asadmin create-jvm-options

"-javaagent\:/<java-agent-home-directory>/javaagent.jar:-Dappdynamics.socket.collection.bci.enable=true"

JBoss スタンドアロン

standalone.sh ファイルに完全なコマンドを追加します。例：

export LD_PRELOAD=/<network-agent-home-directory>/lib/appd-netlib.so

JAVA_OPTS="$JAVA_OPTS -

javaagent:/<java-agent-home-directory>/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true"

Jetty

start.jar を使用したスタンドアロン Jetty の場合：

    1. Jetty ベースディレクトリの start.ini コンフィギュレーション ファイルに完全なコマンドを追加します。例：
      exec
      javaagent:/usr/appd/agents/apm/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true

    2. Jetty を開始するためのスクリプトを作成します。たとえば、以下のとおりです。startJetty.sh:

      export LD_PRELOAD=/usr/appdynamics/agents/netviz/lib/appd-netlib.so java -jar start.jar

組み込み Jetty を使用したサービスの場合：

    1. Jetty を開始するためのスクリプトを作成します。たとえば、 startJetty.sh:
      export LD_PRELOAD=/<network-agent-home-directory>/lib/appd-netlib.so
      java -javaagent:/<java-agent-home-directory>/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true -jar <embedded_jetty_jar>


アプリケーション エージェントが正しく稼働していることを検証するには、次のコマンドを入力します。
strings /proc/<app_pid>/environ

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

これらの手順は、アプリケーション エージェントが Docker ホストネットワーク外の Docker コンテナで実行されている場合にのみ必要です。

  1. 次のファイルを開きます。<app-agent-install-dir>/<version-number>/external-services/netviz/netviz-service.properties
    （このファイルにアクセスするために external-services/netviz.zip の解凍が必要になる場合があります。）
  2. netviz.agent.host.address の場合、Docker ホスト ネットワーク インターフェイスのゲートウェイ IP を指定します。
    この IP を判別するには、Docker ホストで次のコマンドを実行します。
    docker inspect <app_container_name> | grep Gateway 
  3. アプリケーション エージェントを再起動します。 
  4. Docker ホストネットワークが接続されているかどうかを確認するには、コンテナ内から次のコマンドを実行します。
     curl -k -v <host-network-IP>:3892
    応答を受信した場合は、404 Not Found であっても、ネットワークが接続されます。
アプリケーションの再起動（IBM JVM のみ）

モニタリング対象のアプリケーションが IBM JVM で実行されている場合は、ネットワークエージェントが永続的な接続を検出してモニターするために、アプリケーションを再起動する必要があります。


シングル テナント セットアップ（エージェントホスト上の 1 つのアプリケーションのみ）

ネットワークエージェントで同じホスト上の 1 つのアプリケーションノードのみをモニタするようにするには、次の手順を実行します。

アプリケーション エージェントのインストールまたは更新（必要に応じて）

ネットワークの可視性を実現するには、Java アプリケーション エージェント 4.4 以降がネットワークエージェントと同じホストにインストールされている必要があります。詳細については、Install the Java Agentを参照してください。

アプリケーション エージェントでの NetViz 外部サービスフォルダの抽出
  1. 次のフォルダに移動します。<app-agent-install-dir>/<version-number>/external-services
  2. まだ抽出されていない場合は、ZIP の内容が次のフォルダの下に配置されるように netviz.zip アーカイブを抽出します。
        <app-agent-install-dir>/<version-number>/external-services
ソケット インストゥルメンテーションの有効化

これは、エージェントがネットワークメトリックをアプリケーションフローにマップするために必要です。

  1. コントローラで歯車アイコン（）をクリックし、[AppDynamics Agents] > [App Server Agents] を選択します。
  2. テーブルでエージェントを選択し、[Configure] をクリックします。[App Server Agent Configuration] ページが表示されます。 
  3. ツリービュー（左）でアプリケーション、ティア、ノードを選択します。
  4. [Use Custom Configuration] を選択して、[+ Create Agent Property] をクリックします。
  5. [Edit Agent Property] ダイアログで、次のように指定します。
    1. Name = socket-enabled
    2. Type = Boolean
    3. Value = true

Create Agent Property

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

これらの手順は、アプリケーション エージェントが Docker ホストネットワーク外の Docker コンテナで実行されている場合にのみ必要です。

  1. 次のファイルを開きます。<app-agent-install-dir>/<version-number>/external-services/netviz/netviz-service.properties
    （このファイルにアクセスするために external-services/netviz.zip の解凍が必要になる場合があります。）
  2. netviz.agent.host.address の場合、Docker ホスト ネットワーク インターフェイスのゲートウェイ IP を指定します。
    この IP を判別するには、Docker ホストで次のコマンドを実行します。
    docker inspect <app_container_name> | grep Gateway 
  3. アプリケーション エージェントを再起動します。 
  4. Docker ホストネットワークが接続されているかどうかを確認するには、コンテナ内から次のコマンドを実行します。
     curl -k -v <host-network-IP>:3892
    応答を受信した場合は、404 Not Found であっても、ネットワークが接続されます。
アプリケーションの再起動（IBM JVM のみ）

モニタリング対象のアプリケーションが IBM JVM で実行されている場合は、ネットワークエージェントが永続的な接続を検出してモニターするために、アプリケーションを再起動する必要があります。