Linux 上でネットワークエージェントとアプリケーション エージェントを設定する

アプリケーション エージェントでソケット収集を有効にする

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

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

   フレームワーク	例（アプリケーション エージェント ZIP）
   IBM WebSphere および InfoSphere	WebSphere/InfoSphere UI で、モニタ対象サーバの Java Virtual Machine のプロパティページに移動します。次に、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 コンテナで実行されている場合にのみ必要です。

アプリケーションの再起動（IBM JVM のみ）

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

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

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

1. Open the following file in a text editor: <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 以降が必要です。以前のバージョンを実行している各アプリケーション エージェントを更新します。詳細については、Javaエージェントのインストールを参照してください。

アプリケーション エージェントでの 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

     Click here to expand...

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

     フレームワーク	例（アプリケーション エージェント ZIP）
     IBM WebSphere および InfoSphere	WebSphere/InfoSphere UI で、モニタ対象サーバの Java Virtual Machine のプロパティページに移動します。次に、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 サーバに環境変数を追加する方法について説明します。 Cognos サーバの WebSphere Application Server 管理コンソールにログインします。 Servers > Server Types > WebSphere application servers をクリックします。 cognos_server リンクをクリックします。 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 の場合： Jetty ベースディレクトリの start.ini コンフィギュレーション ファイルに完全なコマンドを追加します。例： --exec javaagent:/<java-agent-home-directory>/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true Jetty を開始するためのスクリプトを作成します。たとえば、以下のとおりです。startJetty.sh export LD_PRELOAD=/<network-agent-home-directory>/lib/appd-netlib.so java -jar start.jar   組み込み Jetty を使用したサービスの場合：   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>

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

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

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

アプリケーションの再起動（IBM JVM のみ）

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

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

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

アプリケーション エージェントでの 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. 1. Name = socket-enabled
   2. Type = Boolean
   3. Value = true

アプリケーション エージェントで 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 で実行されている場合は、ネットワークエージェントが永続的な接続を検出してモニタするために、アプリケーションを再起動する必要があります。