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

次の例に示すように、Java アプリケーション エージェント開始コマンドを設定して、2 つの追加タスクを実行する必要があります。
  1. ネットワークエージェントが（ホスト全体ではなく）個々のノードのネットワークメトリックを収集できるように、appd-netlib ライブラリをプリロードします。
  2. ネットワークエージェントの 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. [ServersServer TypesWebSphere 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 コンフィギュレーション ファイルに完全なコマンドを追加します。例：execjavaagent:/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.sojava -javaagent:/<java-agent-home-directory>/javaagent.jar -Dappdynamics.socket.collection.bci.enable=true -jar <embedded_jetty_jar>

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