OMC APM Agentのインストール - JAVA編 -

Oracle Management CloudのApplication Performance Monitoringは、JAVA Application Server、.NET、Node.js上で動作するアプリケーションの性能監視のためのクラウドサービスです。クライアント側、アプリケーションサーバー側の情報を分析することでどこにパフォーマンスの問題があるのかを特定するのに役立ちます。

ここでは、Application Performance Monitoringの設定手順についてご紹介します。対象のAPサーバはApache Tomcatです。

- OMCのコンソールからエージェントをクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/a7e95d9e-db93-baf8-85a4-240108bf8b47.png)

-  右上のアイコンのエージェントのダウンロードをクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/59d06db7-fe6a-d59c-b7de-924591f9e7e7.png)

- エージェントタイプをAPMエージェントを選択し、APM JAVA Agentをクリックしてダウンロード
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/b55e9c11-be3d-7d1a-fd14-ae39aadaeff9.png)

-  右上のアイコンの登録キーの管理をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/ae45d4d1-a08d-bb0d-fbc1-c0bf420b14ce.png)

-  好きな名前を入力し、新規キーの作成をクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/ac007196-bc5b-e272-39c0-d8cf2ab02495.png)

-  生成されたキーの値をメモしておく
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/7c480df3-9641-1a96-c4cb-f9902405958d.png)

- TomcatのインストールされたサーバにAPM Agentをコピーしてログイン

```
APM Agentの解凍
$ unzip 1.46_APM_226.zip -d 1.46_APM_226
$ cd 1.46_APM_226/
$ ls
AgentConfig.info          ApmAgent-1.46.zip  ProvisionApmJavaAsAgent.cmd
agent_software_build.xml  certificates       ProvisionApmJavaAsAgent.sh
ApmAgent-1.46.dat         install            rootCertificates

スクリプトの権限変更
$ chmod 775 ProvisionApmJavaAsAgent.sh

APM Agentのインストール (※環境変数にCATALINA_HOMEが指定されていること)
$ ./ProvisionApmJavaAsAgent.sh -d $CATALINA_HOME
INFO: Starting APM Java agent installer using the following parameters: -d /home/opc/apache-tomcat-9.0.30
INFO: Your install directory is /home/opc/apache-tomcat-9.0.30
INFO: Please enter the registration key or q to quit
-->メモしておいたキーの値を入力

～色々メッセージが流れてインストール完了～

APM Agentの実体は$CATALINA_HOME/apmagentにインストールされている

以下を環境変数に追加してTomcatを再起動
export CATALINA_OPTS="-javaagent:$CATALINA_HOME/apmagent/lib/system/ApmAgentInstrumentation.jar"

```

- 正常にインストールされている場合はAPMエージェントの項目に表示される
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/833852b8-b3f1-28b8-35a7-8459207ed40b.png)

- APMをクリック
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/474b7a9f-1fcd-24ff-69d0-e490823d6c51.png)

- サーバーリクエスト、APPServerにデータが表示され、APMの監視がスタート
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/d6318f33-4280-ffa1-8aac-6cf147fc168e.png)

- サーバーリクエスト毎の詳細なパフォーマンス分析
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/562423/9e4d457a-9a22-86f0-7826-42b4844304a9.png)

- エンドユーザー・モニタリングの有効化 (ユーザのブラウザ操作を記録)の設定方法は、OMC APM Agentのインストール - .NET編 -を参照して下さい
https://qiita.com/western24/items/855cee9d2c0a93b8cf79

今回はTomcatをご紹介しましたが、それ以外のサポートしているWeb Application Serverは、WebLogic、WebSphere、Jboss、Jettyです。各APサーバごとにAPM Agentのインストール手順が若干異なりますので、[マニュアル](https://docs.oracle.com/cd/E83857_01/paas/management-cloud/dmapm/introduction-application-performance-monitoring.html#GUID-DD7ECE8E-ADE5-4CA4-AD1F-C72DA85C3FBF)を参考にして下さい。




Oracle Management Cloud関連の情報は[こちら](https://qiita.com/western24/items/1e44bfcaa77f3251a263)