AppDynamics Agent Installer による Java / Machine Agent の自動インストール

agent installer

はじめに

前回のブログ投稿で、Ansible を用いた AppDynamics Java / Machine Agent の自動インストール/インスツルメント方法を紹介しましたが、今回は比較的新しいインストール方法である、Agent Installer(Zero Agent)について解説したいと思います。

Agent Installer(Zero Agent)対応アプリケーション実行環境

Agent Installer は以下のアプリケーション実行環境に対応します。

OS

・RHEL 7 / 8
・CentOS 7
・Ubuntu 18.04
・Fedora 31
・Debian 10

JVM(Java Virtual Machine)

・Open JDK 1.6+
・Oracle JDK 1.7+
・IBM JDK 1.6+

アプリケーションサーバ

・Apache Tomcat
・GlassFish
・JBoss WildFly
・Weblogic
・WebSphere
・AppDynamics コントローラは SaaS コントローラ 20.6+ である必要があります。

テスト環境

今回は以下のテスト環境を用いました。

CentOS 7.9.2009
AppDynamics SaaS Controller build 21.8.0-813
アプリケーションサーバ: GlassFish 4.1
OpenJDK 1.8.0.302
Proxy サーバ: Squid 3.5.20

多くのお客様では HTTP proxy を経由して各 Agent から AppDynamics コントローラへの接続を行っている場合が多いため、Agent Installer を用いて Java / Machine Agent をインストールするホストとは別のホスト上で Squid 3.5 を稼働させました。

事前準備

デフォルト設定では、AppDynamics コントローラUI の Home に Agent Installer タブが表示されません。⚙ – Administration – Roles で、新規もしくは既存 Role に Install Agents Permission を追加し、Agent Installer を利用するユーザにこのロールを割り当てます。

Install Agents 権限を付与した後、ブラウザの Reload ボタンをクリックしますと、 Home に次のように Agent Installer タブが表示されますので、これをクリックします。

1. SPECIFY APPLICATION TO DEPLOY TO

今回は新規にアプリケーションを監視しますので、1. SPECIFY APPLICATION TO DEPLOY TO で、+ New Application を選択、アプリケーション名を入力します。

2. DOWNLOAD AND RUN THE AGENT INSTALLER

インストーラ/エージェントのダウンロード

2. DOWNLOAD AND RUN THE AGENT INSTALLER では、Express Installation を選択します。

Copy and paste the command into your terminal or automated tools. の右端のアイコンをクリックしますと各エージェント/インストールスクリプトをダウンロードするためのコードスニペットがクリップボードにコピーされますので、GlassFish サーバ上でコマンドをペースト、実行します。


$ cd $(mktemp -d -t appd-zero-XXXXXXX) && curl https://download-files.appdynamics.com/download-file/zero-agent-bootstrap/21.7.0.287/appdynamics-zero-agent-bootstrap-21.7.0.287.sh -o zero-agent.sh && chmod +x zero-agent.sh && ./zero-agent.sh download sun-java -v 21.7.0.32930 -c fb6decc4c433ead62aafb4c7ea4c9ae0 && ./zero-agent.sh download ibm-java -v 21.7.0.32930 -c 604f9de7b90ba9e251dacaaba363470f && ./zero-agent.sh download machine -v 21.7.0.3160 -c 24cd76b6144c56c78063112f154b53bd && ./zero-agent.sh download zero -v 21.7.0.287 -c 7a463e3553b6e8357537c45b1c148f28

  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 12348  100 12348    0     0  53947      0 --:--:-- --:--:-- --:--:-- 54157
INFO: Downloading sun-java agent from https://download-files.appdynamics.com/download-file/sun-jvm/21.7.0.32930/AppServerAgent-21.7.0.32930.zip
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 21.5M  100 21.5M    0     0  44.7M      0 --:--:-- --:--:-- --:--:-- 44.8M
INFO: Successfully downloaded AppServerAgent-21.7.0.32930.zip
INFO: Integrity check passed!
INFO: Downloading ibm-java agent from https://download-files.appdynamics.com/download-file/ibm-jvm/21.7.0.32930/AppServerAgent-ibm-21.7.0.32930.zip
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 21.5M  100 21.5M    0     0  47.3M      0 --:--:-- --:--:-- --:--:-- 47.2M
INFO: Successfully downloaded AppServerAgent-ibm-21.7.0.32930.zip
INFO: Integrity check passed!
INFO: Downloading machine agent from https://download-files.appdynamics.com/download-file/machine-bundle/21.7.0.3160/machineagent-bundle-64bit-linux-21.7.0.3160.zip
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  137M  100  137M    0     0  76.2M      0  0:00:01  0:00:01 --:--:-- 76.2M
INFO: Successfully downloaded machineagent-bundle-64bit-linux-21.7.0.3160.zip
INFO: Integrity check passed!
INFO: Downloading zero agent from https://download-files.appdynamics.com/download-file/zero-agent/21.7.0.287/appdynamics-zero-agent-21.7.0.287.zip
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100 25.3M  100 25.3M    0     0  52.9M      0 --:--:-- --:--:-- --:--:-- 52.8M
INFO: Successfully downloaded appdynamics-zero-agent-21.7.0.287.zip
INFO: Integrity check passed!

ダウンロードが正常に行われない場合は以下の環境変数(proxy 設定)を確認してください。


http_proxy=http://10.0.0.99:3128
https_proxy=http://10.0.0.99:3128

正常にダウンロードが行われた場合は /tmp 以下の一時ディレクトリに以下のファイルがダウンロードされます。


-rwxr-xr-x 1 goto appd  13K Aug 21 10:49 zero-agent.sh
-rw-r--r-- 1 goto appd  22M Aug 21 10:49 AppServerAgent-21.7.0.32930.zip
-rw-r--r-- 1 goto appd  22M Aug 21 10:49 AppServerAgent-ibm-21.7.0.32930.zip
-rw-r--r-- 1 goto appd 138M Aug 21 10:49 machineagent-bundle-64bit-linux-21.7.0.3160.zip
-rw-r--r-- 1 goto appd  26M Aug 21 10:49 appdynamics-zero-agent-21.7.0.287.zip

Zero Agent のインストール

さきほどのコードスニペットの下の Show Command をクリックしますと、Zero Agent をインストールするためのコードスニペットが表示されます。
インストールコマンドは通常以下のようなものになります。


sudo ./zero-agent.sh install --application 'GlassFish4' \
  --account 'your-account-name' --access-key 'your-access-key' \
  --service-url 'https://your-account-name.saas.appdynamics.com'

こちらも GlassFish サーバ上にコピー/ペースト、実行します。


$ sudo ./zero-agent.sh install --application 'GlassFish4' \
  --account 'your-account-name' --access-key 'your-access-key' \
  --service-url 'https://your-account-name.saas.appdynamics.com'

INFO: Extracting AppServerAgent-21.7.0.32930.zip...
INFO: Extracting AppServerAgent-ibm-21.7.0.32930.zip...
INFO: Extracting machineagent-bundle-64bit-linux-21.7.0.3160.zip...
INFO: Extracting appdynamics-zero-agent-21.7.0.287.zip...
INFO: Installing AppDynamics Zero Agent...
Staging path is "/tmp/appd-zero-2UFEmBh"
Installation path is "/opt/appdynamics/zeroagent"
No active installation found. Installation can proceed.
Installing Zero Agent
Directory "/opt/appdynamics/zeroagent" created
Directory "/opt/appdynamics/zeroagent/bin" created
Directory "/opt/appdynamics/zeroagent/configs" created
Directory "/opt/appdynamics/zeroagent/agents" created
Directory "/usr/local/lib" created
Directory "/usr/local/lib64" created
Directory "/opt/appdynamics/zeroagent/pids" created
Directory "/opt/appdynamics/zeroagent/logs" created
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/bin/zeroctl" -> "/opt/appdynamics/zeroagent/bin/zeroctl"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/bin/zeroagent" -> "/opt/appdynamics/zeroagent/bin/zeroagent"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/bin/zerowatchdog" -> "/opt/appdynamics/zeroagent/bin/zerowatchdog"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/lib/libdecorator.so" -> "/usr/local/lib/libdecorator.so"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/lib/libpreload.so" -> "/usr/local/lib/libpreload.so"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/lib64/libdecorator.so" -> "/usr/local/lib64/libdecorator.so"
Copied "/tmp/appd-zero-2UFEmBh/zeroagent/lib64/libpreload.so" -> "/usr/local/lib64/libpreload.so"
Created symbolic link from "/usr/local/lib/zeroagent" to "/opt/appdynamics/zeroagent"
Created symbolic link from "/usr/local/lib64/zeroagent" to "/opt/appdynamics/zeroagent"
Applied permission "0777" to "/opt/appdynamics/zeroagent/pids"
Applied permission "0777" to "/opt/appdynamics/zeroagent/logs"
Applied permission "0755" to "/opt/appdynamics"
Configuring Zero Agent
Installing Java Agent
Directory "/opt/appdynamics/zeroagent/agents" created
Directory "/opt/appdynamics/zeroagent/agents/java" created
Copied "/tmp/appd-zero-2UFEmBh/javaagent" -> "/opt/appdynamics/zeroagent/agents/java/javaagent"
Skipped "/tmp/appd-zero-2UFEmBh/javaagent/ver21.7.0.32930" -> "/opt/appdynamics/zeroagent/agents/java/javaagent/ver21.7.0.32930"
Copied "/tmp/appd-zero-2UFEmBh/ibm-javaagent/ver21.7.0.32930/javaagent.jar" -> "/opt/appdynamics/zeroagent/agents/java/javaagent/ver21.7.0.32930/javaagent-ibm.jar"
Applied permission "0777" to "/opt/appdynamics/zeroagent/agents/java/javaagent/ver21.7.0.32930/conf"
Applied permission "0777" to "/opt/appdynamics/zeroagent/agents/java/javaagent/ver21.7.0.32930/logs"
Global preload library installed
Configuring Java Agent
Installing Machine Agent
Directory "/opt/appdynamics/zeroagent/agents" created
Directory "/opt/appdynamics/zeroagent/agents/machineagent" created
Copied "/tmp/appd-zero-2UFEmBh/machineagent" -> "/opt/appdynamics/zeroagent/agents/machineagent"
Configuring Machine Agent
Installing appdynamics-zero-agent as a systemd service
Creating appdynamics-zero-agent service file in systemd
Successfully created appdynamics-zero-agent service file in systemd
Enabling appdynamics-zero-agent as a systemd service
Reloading systemd daemon
Starting appdynamics-zero-agent service
Waiting for service to start...
Service successfully started

正常にインストールが完了した場合は上記のような実行結果となります。

Proxy 設定

この状態では、Java / Machine Agent から AppDynamics コントローラへ通信ができていない状態のため、proxy 設定を実施する必要があります。


sudo /opt/appdynamics/zeroagent/bin/zeroctl configure --proxy-url=http://proxy_host:3128

Proxy 設定は /opt/appdynamics/zeroagent/configs/zero-config.json に保存されますので、念のため確認を行います。


$ grep proxy /opt/appdynamics/zeroagent/configs/zero-config.json
  "proxyConfig": {
    "proxyHost": "proxy_host",
    "proxyPort": 3128,
    "proxySsl": false

Server Visibility 有効化

Zero Agent でインストールされる Machine Agent では、サーバの CPU、RAM、ディスク、ネットワーク、プロセス情報などを監視するための Server Visibility が有効になっていません。

/opt/appdynamics/zeroagent/agents/machineagent/conf/controller-info.xml を以下のように設定し、sim-enabled エレメントを true にします。


<?xml version="1.0" encoding="UTF-8"?>
<controller-info>
 <controller-host>your-account-name.saas.appdynamics.com</controller-host>
 <controller-port>443</controller-port>
 <controller-ssl-enabled>true</controller-ssl-enabled>
 <account-access-key>your-access-key</account-access-key>
 <account-name>your-account-name</account-name>
 <sim-enabled>true</sim-enabled>
 <unique-host-id></unique-host-id>
</controller-info>

zeroctl コマンドを用い、Zero Agent を再起動します。


sudo /opt/appdynamics/zeroagent/bin/zeroctl stop
sudo /opt/appdynamics/zeroagent/bin/zeroctl start

GlassFish の再起動

Zero Agent による Java アプリケーションへのエージェントのインスツルメントには、GlassFish の再起動が必要となります。今回は ~sagoto/glassfish4 に GlassFish4 を展開していますので、以下のように asadmin コマンドにより再起動を行いました。


$ ./glassfish4/bin/asadmin stop-domain
Waiting for the domain to stop .
Command stop-domain executed successfully.

$ ./glassfish4/bin/asadmin start-domain
Waiting for domain1 to start ........................
Successfully started the domain : domain1
domain  Location: /home/sagoto/glassfish4/glassfish/domains/domain1
Log File: /home/sagoto/glassfish4/glassfish/domains/domain1/logs/server.log
Admin Port: 4848
Command start-domain executed successfully.

Monitoring Settings の確認

Home – Monitoring Settings を確認しますと、正常に Zero Agent のインストール、GlassFish への Java Agent のインスツルメントが行われた場合、次のような表示となります。

今回は、~sagoto/glassfish4/glassfish/domains/domain1 でサンプルアプリケーションを稼働させていますが、Zero Agent により自動的に検知、インスツルメントできていることが確認できます。

トラフィック/負荷の生成

アプリケーションにトランザクションが発生していないと監視メトリック等が AppDynamics コントローラに送信されませんので、以下のようなシェルスクリプトを用いて 10 秒おきに GlassFish Hello サンプルアプリケーションにトラフィックを発生させます。


watch -n10 curl --noproxy localhost -s http://localhost:8080/hello/?username=AppDynamics

アプリケーション・フローマップ、Machine Agent ダッシュボードの確認

AppDynamics コントローラ上でアプリケーション・フローマップを確認します。

上図のようにアプリケーション・フローマップが表示されていれれば、正常に Java Agent がインスツルメントされていることが確認できます。

次に Servers ダッシュボードを確認します。

正常に各メトリックが取得できていることが確認できました。

まとめ

今回は Agent Installer(Zero Agent) を用いて GlassFish 4 アプリケーションに対して、AppDynamics Java / Machine Agent を自動インスツルメントしました。proxy 設定と、Server Visibility の有効化がやや煩雑と思われるかもしれませんが、対応している実行環境であれば、従来と比較し非常に簡単にエージェントのインストールを行うことが可能であることがおわかり頂けたかと存じます。

Tags: APMAppDynamicsJava AgentObservabilityオブザーバビリティ

2021年8月25日

後藤智

セールスエンジニア

Cisco AppDynamics

2020年に Cisco 入社。

ビジネス・オブザーバビリティ(可観測性)・ソリューション AppDynamics の技術適合性検討，導入価値検証(Proof of Value)の技術的支援(プリセールス)を担当。

Next Webex の新機能：2021 年 7 月 »

Previous « サービスプロバイダーのイノベーションがデジタルデバイド（情報格差）解消の鍵に