#chiroito ’s blog

Java を中心とした趣味の技術について

Oracle Management Cloud エージェントをインストールしてみる

はじめに

システムを運用するときは、ログやメトリックをモニタリングします。オンプレのシステムでは決まった台数を監視すれば良いことが多いです。また、ストレージが書き込める限り、あとからストレージからログやメトリックを収集できます。クラウドでは状況に合わせて台数がスケールします。問題が発覚した頃にはそのインスタンスがスケールインなどによってなくなっている可能性があるためログやメトリックを常にどこかへ転送しなければなりません。

Oracle Management Cloud Service ではエージェントをインストールするだけでオンプレやクラウドサービスを問わずOS、ミドルウェア、アプリケーションまでのログやメトリックを収集して見ることができるようになります。ミドルウェアはOracle製品に限らず、Dockerコンテナなどにも対応しています。

f:id:chiroito:20190126165424p:plain
Oracle Management Cloud

エージェントには、汎用的な情報を取り扱う Cloud Agent と、特定のミドルウェアに特化した情報を取り扱う APMエージェントの 2 種類があります。実際の分析の現場では、アプリケーションはミドルウェア上で動いているため、何か問題が発生したらAPMエージェントによって収集された情報を使ってミドルウェアレベルで問題を分析してから、Cloud Agent によって収集されたより低レベルな OS の問題を分析していきます。

エージェントのインストール

汎用的な情報を取るか、ミドルウェア特化の情報を取るかによってCloud Agent か APM Agent を組み合わせて使用します。その他にもシステムの構成によって以下のような構成を組めます。 ポイントは以下です。

  • Oracle Management Cloud までの間に Http プロキシがあるかどうか(あるなら設定で対応)
  • 各エージェントから直接 Oracle Management Cloud へデータを送るか(途中で取りまとめるなら Gateway をインストール)
  • Oracle Enterprise Manager に格納されてる情報を Oracle Management Cloud へ送るか (送るなら Data Collectorをインストール)

https://docs.oracle.com/cd/E83857_01/paas/management-cloud/emaig/img/emcad_dt_004_1.png 図:エージェントの配置例

今回は、もっともシンプルな構成とします。エージェントが収集した汎用的な情報だけをプロキシやGatewayを使わずに直接送る構成です。 以下の手順をしていきます。

  • キーの作成
  • Cloud Agent のインストール
  • Cloud Agent の確認

キーの作成

キーの作成は Oracle Management Cloud の管理コンソールで行います。名前登録制限設定し、新規キーの作成ボタンを押すだけで作成されます。 登録制限は接続可能なエージェントの数を指定します

f:id:chiroito:20190126171624p:plain
登録キーの新規作成

キーを作成すると以下のように表示されるようになります。以下はすでに 2 つのエージェントが登録した例です。Cloudエージェントのインストールでキー値を使うため控えておきます。

f:id:chiroito:20190126171739p:plain
作成済の登録キーの一覧

参考:Manage Registration Keys

Cloud Agentのインストール

キーの作成が終わったらエージェントをインストールします。

Cloudエージェントのダウンロード

Cloudエージェントはダウンロードタブでダウンロードします。 エージェントタイプは以下の 4 つから選択します。今回はログやOSの汎用的な情報を取得するクラウド・エージェントをダウンロードします。

  • ゲートウェイ
  • データ・コレクタ
  • クラウド・エージェント
  • APMエージェント

また、CloudエージェントのインストールでTENANT_NAMEOMC_URLを使うため控えておきます。

f:id:chiroito:20190126165613p:plain
Oracle Management Cloud エージェントのダウンロード

レスポンスファイルの設定

次にレスポンスファイルであるagent.rspファイルにある以下の 4 つのパラメータを設定します。

  • TENANT_NAME:ダウンロード画面で控えたTENANT_NAME
  • AGENT_REGISTRATION_KEY:登録キーの作成で控えたキー値
  • AGENT_BASE_DIRECTORY:エージェントをインストールしたいディレクトリ
  • OMC_URL:ダウンロード画面で控えたOMC_URL

Cloudエージェントでプロキシやゲートウェイを使う場合はこちらを参照してください
クラウド・エージェントをインストールするためのパラメータ

データコレクタをインストールする場合はこちら
データ・コレクタをインストールするためのパラメータ

ゲートウェイをインストールする場合はこちら
ゲートウェイをインストールするためのパラメータ

agent.rsp

####################################################################################################
# Refer Agent Installation Guide for details                                                       #
#  http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent       #
# Refer this link for mandatory and non-mandatory parameter details                                #
#  http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_gateway     #
####################################################################################################

###################################### Registration Parameters #####################################

TENANT_NAME=4fXXXXXXXXXXXXXXXXXXXXXXXXXXXX5d

AGENT_REGISTRATION_KEY=RcXXXXXXXXXXXXX-XXXXXXXXeS

AGENT_BASE_DIRECTORY=C:\Oracle\cloudagent

##################################### Communication Parameters #####################################

OMC_URL=https://4fXXXXXXXXXXXXXXXXXXXXXXXXXXXX5d.uscom-east-1.oraclecloud.com/

設定値の検証

レスポンスファイルに設定した内容でOracle Management Cloud へ通信できるか、エージェントをインストールできるかなど設定値を検証します。

検証にはこのあとインストールで使うAgentInstall.batEXECUTE_PREREQ=trueを付けて実行します。なお、Linux版の場合はAgentInstall.shになります。

> AgentInstall.bat EXECUTE_PREREQ=true
Unzipping agent software, this may take some time...
Installing Cloud Agent...
Executing Pre-requisite checks only for Cloud Agent...
Cloud Agent parameter validation started...
Cloud Agent pre-requisite checks started...
Pre-requisite checks successfully completed for [Cloud Agent].

Cloudエージェントのインストール

検証が成功したら実際にインストールしてみます。

Windowsの場合

Windowsではサービスとして実行されます。

> AgentInstall.bat
Unzipping agent software, this may take some time...
Installing Cloud Agent...
Cloud Agent parameter validation started...
Cloud Agent pre-requisite checks started...
Cloud Agent base directory creation started...
Security artifacts download started...
Cloud Agent setup started...
Registering Cloud Agent...
Starting Cloud Agent...
Cloud Agent started.
Cloud Agent installation completed.
Cloud Agent post installation checks started.
Cloud Agent is up and running.
Cloud Agent is communicating to Oracle Management Cloud.
Cloud Agent is monitored in Oracle Management Cloud.
Cloud Agent post installation checks completed.
Linuxの場合

Linux の場合は、デーモンとして実行されます。検証のログは変りませんが、インストールのログは以下のようになります。

[chito@localhost cloudagent]$ ./AgentInstall.sh
Unzipping agent software, this may take some time...
Installing Cloud Agent...
Cloud Agent parameter validation started...
Cloud Agent pre-requisite checks started...
Cloud Agent base directory creation started...

Security artifacts download started...
Cloud Agent setup started...
Registering Cloud Agent...
Starting Cloud Agent...
Cloud Agent started.
Cloud Agent installation completed.
Cloud Agent post installation checks started.
Cloud Agent is up and running.
Cloud Agent is communicating to Oracle Management Cloud.
Cloud Agent is monitored in Oracle Management Cloud.
Cloud Agent post installation checks completed.
To start Cloud Agent upon Operating System restart include '/home/chito/cloudagent/agent_inst/bin/omcli start agent' in the start-up scripts.
For further details please refer http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent.

インストール完了後はagent_inst/bin/omcli start agentを実行してCloudエージェントを実行します。

Cloud エージェントの削除

インストール先を変えるなどでもし削除したくなったら <AGENT_BASE_DIRECTORY>\core\<AGENT_VERSION>\perl\bin\perl <AGENT_BASE_DIRECTORY>\core\<AGENT_VERSION>\sysman\install\AgentInstall.pl -deinstallを実行して削除します

Cloudエージェントの状況を確認する。

レスポンスファイルで指定したディレクトリからagent_inst/binへ進むとエージェントとのやりとりを行うomcliがあり、これを使います。 Cloudエージェントの状況はomcli status agentで確認します。

> set PATH=%PATH%;%AGENT_BASE_DIRECTORY%\agent_inst\bin
> omcli status agent
Oracle Management Cloud Agent
Copyright (c) 1996, 2018 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Version                : 1.37.0
State Home             : C:/Oracle/cloudagent/agent_inst
Log Directory          : C:/Oracle/cloudagent/agent_inst\sysman\log
Binaries Location      : C:\Oracle\cloudagent\core\1.37.0
Process ID             : 23208
Parent Process ID      : 27560
URL                    : https://CHIXXXXXXXXXXX.oracle.com:4459/emd/main/
Started at             : 2019-01-19 13:50:12
Started by user        : CHITO-JP$
Operating System       : Windows version 10.0 (amd64)
Data Collector enabled : false
Sender Status          : FUNCTIONAL
Gateway Upload Status  : FUNCTIONAL
Last successful upload : 2019-01-19 14:25:31
Last attempted upload  : 2019-01-19 14:25:30
Pending Files (MB)     : 0
Pending Files          : 5
Backoff Expiration     : (none)

---------------------------------------------------------------
Agent is Running and Ready

定期的に情報をOracle Management Cloud へ送信するため、Last successful uploadが更新されていけば情報が送れています。

また、Oracle Management Cloudのコンソールのクラウド・エージェントからも接続できているかを確認できます。

f:id:chiroito:20190126165722p:plain
Cloud エージェントの確認

ここまでできればインストールは成功です。