• Oracle Database
• Zabbix
• データベース運用
• 2022.08.25
• 渡部 亮太

Oracle by Zabbix agent 2 (oracle_agent2)の概要と導入方法

Oracle ACE Proの渡部です。 Zabbixが標準で提供しているOracle監視方法である「Oracle by Zabbix agent 2」 (oracle_agent2)の概要と導入方法について説明します。 弊社では、多くのお客様にZabbixを用いたOracle監視を導入しております。

Oracle by Zabbix agent 2とは

Oracle by Zabbix agent 2 (oracle_agent2)とは、Zabbix Agent 2で使用可能なOracle監視方式です。 Oracle by Zabbix agent 2の特徴は以下のとおりです。

• Zabbixに標準添付されています（おそらくバージョン5.0.5から）。
• 実体は、GO言語で実装されたZabbix Agent 2のプラグインです。
• 監視項目はテンプレート「Oracle by Zabbix agent 2」に含まれており、ホストをテンプレート「Oracle by Zabbix agent 2 」をリンクすると監視項目をホストに適用できます。

監視処理はZabbix Agent 2に実装されており、監視動作のイメージは以下のようになります。

関連URLは以下のとおりです。

• https://www.zabbix.com/documentation/6.0/en/manual/appendix/config/zabbix_agent2_plugins/oracle_plugin
• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2
• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle

監視項目

Oracle by Zabbix agent 2を導入して適用できる監視項目については、

• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle
  の "Supported keys"
• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2 の "Items collected"

に記載されています。主に、起動ステータス、使用率、セッション数などの量的な性能数値が収集されます。

インストール手順

インストール手順は以下にざっくり記載されていますが、若干不親切です。

• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_agent2
• https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle

具体的な手順を以下に示します。

前提

• Zabbix Server構成済みで起動中
• 監視対象ホストにOracleデータベースが構成済みで起動中
• Oracleデータベースにリモート接続可能

環境

• 監視サーバ: 172.31.34.31
• 監視対象ホスト: l8dpa223ad1.domain (172.31.35.31)
• 監視対象データベースのデータベースサービス名: j15n.world (Oracle Database 19c, 非CDB構成)

1. Zabbix Agent 2をインストールする

監視対象ホストにZabbix Agent 2をインストールします。

[root@l8dpa223ad1 ~]# rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-2.el8.noarch.rpm
Retrieving https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-2.el8.noarch.rpm
dnf clean all
warning: /var/tmp/rpm-tmp.CFIcv8: Header V4 RSA/SHA512 Signature, key ID a14fe591: NOKEY
Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:zabbix-release-6.0-2.el8         ################################# [100%]
[root@l8dpa223ad1 ~]# dnf clean all
184 files removed
[root@l8dpa223ad1 ~]#
[root@l8dpa223ad1 ~]# yum install zabbix-agent2.x86_64
Oracle Linux 8 Application Stream (x86_64)                                                             9.6 MB/s | 7.2 MB     00:00
Oracle Linux 8.5 BaseOS (x86_64)                                                                        12 MB/s | 3.3 MB     00:00
Zabbix Official Repository - x86_64                                                                     82 kB/s | 107 kB     00:01
Zabbix Official Repository non-supported - x86_64                                                      1.3 kB/s | 1.2 kB     00:00
Zabbix Official Repository (Agent2 Plugins) - x86_64                                                   1.2 kB/s | 1.1 kB     00:00
Dependencies resolved.
=======================================================================================================================================
 Package                             Architecture                 Version                           Repository                    Size
=======================================================================================================================================
Installing:
 zabbix-agent2                       x86_64                       6.0.7-1.el8                       zabbix                       5.3 M

Transaction Summary
=======================================================================================================================================
Install  1 Package

Total download size: 5.3 M
Installed size: 19 M
Is this ok [y/N]: y
Downloading Packages:
zabbix-agent2-6.0.7-1.el8.x86_64.rpm                                                                   1.0 MB/s | 5.3 MB     00:05
---------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                  1.0 MB/s | 5.3 MB     00:05
Zabbix Official Repository - x86_64                                                                    1.6 MB/s | 1.7 kB     00:00
Importing GPG key 0xA14FE591:
 Userid     : "Zabbix LLC "
 Fingerprint: A184 8F53 52D0 22B9 471D 83D0 082A B56B A14F E591
 From       : /etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591
Is this ok [y/N]: y
Key imported successfully
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transaction
  Preparing        :                                                                                                               1/1
  Running scriptlet: zabbix-agent2-6.0.7-1.el8.x86_64                                                                              1/1
  Installing       : zabbix-agent2-6.0.7-1.el8.x86_64                                                                              1/1
  Running scriptlet: zabbix-agent2-6.0.7-1.el8.x86_64                                                                              1/1
  Verifying        : zabbix-agent2-6.0.7-1.el8.x86_64                                                                              1/1

Installed:
  zabbix-agent2-6.0.7-1.el8.x86_64

Complete!
[root@l8dpa223ad1 ~]# cp -p /etc/zabbix/zabbix_agent2.conf{,.20220823BK}
[root@l8dpa223ad1 ~]# vi /etc/zabbix/zabbix_agent2.conf
[root@l8dpa223ad1 ~]# diff /etc/zabbix/zabbix_agent2.conf{,.20220823BK}
80c80
< Server=172.31.34.31
---
> Server=127.0.0.1
132c132
< ServerActive=172.31.34.31
---
> ServerActive=127.0.0.1
[root@l8dpa223ad1 ~]# systemctl start  zabbix-agent2
[root@l8dpa223ad1 ~]# systemctl status zabbix-agent2
● zabbix-agent2.service - Zabbix Agent 2
   Loaded: loaded (/usr/lib/systemd/system/zabbix-agent2.service; disabled; vendor preset: disabled)
   Active: active (running) since Tue 2022-08-23 20:57:55 JST; 4s ago
 Main PID: 2456 (zabbix_agent2)
    Tasks: 6 (limit: 48694)
   Memory: 3.9M
   CGroup: /system.slice/zabbix-agent2.service
           mq2456 /usr/sbin/zabbix_agent2 -c /etc/zabbix/zabbix_agent2.conf

Aug 23 20:57:55 l8dpa223ad1.domain systemd[1]: Started Zabbix Agent 2.
Aug 23 20:57:55 l8dpa223ad1.domain zabbix_agent2[2456]: Starting Zabbix Agent 2 (6.0.7)
Aug 23 20:57:55 l8dpa223ad1.domain zabbix_agent2[2456]: Zabbix Agent2 hostname: [Zabbix server]
Aug 23 20:57:55 l8dpa223ad1.domain zabbix_agent2[2456]: Press Ctrl+C to exit.
[root@l8dpa223ad1 ~]#
[root@l8dpa223ad1 ~]# systemctl enable zabbix-agent2
Created symlink /etc/systemd/system/multi-user.target.wants/zabbix-agent2.service → /usr/lib/systemd/system/zabbix-agent2.service.
[root@l8dpa223ad1 ~]#
[root@l8dpa223ad1 ~]#

2. 監視対象ホストを登録

Zabbix ServerのWebインタフェースで、監視対象ホストを登録します（"Create Host"）。

3. Oracle Instant Clientをインストールする

監視対象ホストにOracle Instant Clientをインストールします。

• https://www.oracle.com/jp/topics/technologies/download-instant-client.html

[root@l8dpa223ad1 ~]# wget https://download.oracle.com/otn_software/linux/instantclient/1916000/oracle-instantclient19.16-basic-19.16.0.0.0-1.x86_64.rpm
--2022-08-23 21:02:52--  https://download.oracle.com/otn_software/linux/instantclient/1916000/oracle-instantclient19.16-basic-19.16.0.0.0-1.x86_64.rpm
Resolving download.oracle.com (download.oracle.com)... 104.115.164.102
Connecting to download.oracle.com (download.oracle.com)|104.115.164.102|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 53459024 (51M) [application/x-redhat-package-manager]
Saving to: ‘oracle-instantclient19.16-basic-19.16.0.0.0-1.x86_64.rpm’

oracle-instantclient19.16-basic-1 100%[============================================================>]  50.98M  11.0MB/s    in 4.6s

2022-08-23 21:02:58 (11.0 MB/s) - ‘oracle-instantclient19.16-basic-19.16.0.0.0-1.x86_64.rpm’ saved [53459024/53459024]

[root@l8dpa223ad1 ~]# rpm -ivh oracle-instantclient19.16-basic-19.16.0.0.0-1.x86_64.rpm
Verifying...                          ################################# [100%]
Preparing...                          ################################# [100%]
Updating / installing...
   1:oracle-instantclient19.16-basic-1################################# [100%]

• 19.3より古いOracle Instant Clientでは、環境変数LD_LIBRARY_PATHの設定が必要です。
  • 19.3以降のOracle Instant ClientのRPMパッケージには /etc/ld.so.conf.d/oracle-instantclient.confが含まれているため、環境変数LD_LIBRARY_PATHの設定が不要。
• 必要に応じてNLS_LANG, CLASSPATH, ORACLE_SID, TNS_ADMIN などの環境変数を設定します。

Zabbix監視接続用のOracleユーザーを作成

監視対象のOracleデータベースに、Zabbix監視接続用のOracleユーザーを作成します。

Oracleユーザーに付与すべき権限についてのマニュアルの記載はおそらく正しくないです。 SELECT ANY DICTIONARY権限を付与することをお勧めします。

CREATE USER zabbix_mon IDENTIFIED BY zabbix_mon;
GRANT CONNECT, CREATE SESSION TO zabbix_mon;
GRANT SELECT ANY DICTIONARY TO zabbix_mon ;

Zabbix-agent2.serviceのLimitNOFILEを65536にする

• https://catonrug.blogspot.com/2021/12/install-docker-centos-8-compile-oracle.html

の記載に従い、Zabbix-agent2.serviceのLimitNOFILEを65536にします。 これは状況によっては不要かもしれません。

[oracle@l8dpa223ad1 ~]$ sudo mkdir /etc/systemd/system/zabbix-agent2.service.d
[oracle@l8dpa223ad1 ~]$ sudo vi /etc/systemd/system/zabbix-agent2.service.d/limit.conf
[oracle@l8dpa223ad1 ~]$ cat /etc/systemd/system/zabbix-agent2.service.d/limit.conf
[Service]
LimitNOFILE=65536

[oracle@l8dpa223ad1 ~]$ sudo systemctl daemon-reload
[oracle@l8dpa223ad1 ~]$ sudo systemctl restart  zabbix-agent2

監視対象ホストへテンプレート "Oracle by Zabbix agent 2" をリンク

Zabbix ServerのWebインタフェースで、 監視対象ホストへテンプレート "Oracle by Zabbix agent 2" をリンクします。

ホスト固有情報用のユーザーマクロを設定する

Zabbix ServerのWebインタフェースで、監視対象ホストのユーザーマクロとして、ホスト固有の情報を設定します。

具体的には、以下のユーザーマクロを設定します。

• {$ORACLE.USER} : Zabbix監視接続用のOracleユーザーのユーザー名
• {$ORACLE.PASSWORD} : Zabbix監視接続用のOracleユーザーのパスワード
• {$ORACLE.SERVICE} : 監視対象DBのデータベースサービス名
• {$ORACLE.CONNSTRING} : 監視対象DBのリスナー接続情報。tcp://localhost:1521 のような形式で指定する

上記の作業が完了すると、Oracle by Zabbix agent 2 (Agent 2)から監視対象のOracleデータベースに 接続可能になり、アイテムの監視データが収集されます。

収集された監視データはグラフとして表示できます。

併せて、ディスカバリアイテムが実行され、アイテムが自動的に作成されます。

Oracle by Zabbix agent 2 にはLLD(ローレベルディスカバリ)が実装されており、 以下のディスカバリアイテムがデータベースの構造に応じてアイテムを自動的に作成できます。

• Database discovery
• Tablespace discovery
• Archive log discovery
• ASM disk groups discovery
• PDB discovery

Oracle by Zabbix agent 2 以外のOracle監視方式

ZabbixのOracle監視方式 全5種類

コーソルのデータベース運用関連製品とサービス

コーソルでは、データベース運用を製品とサービスでご支援します。

Database Performance Analyzer （DPA）

Database Performance Analyzer （DPA）は、オンプレミスとクラウド上の多くのデータベース製品に対応したデータベース性能管理製品です。低価格であるため、非常に導入しやすいです。

Zabbixの苦手なデータベース性能監視を補うことができます。

• https://cosol.jp/license/dpa/

Database Performance Analyzer （DPA）

リモートDBAサービス

リモートDBAサービスはDB・運用の専門家がお客様のデータベースに対して 必要な時に必要な対応を行うリモート接続型運用保守サービスです。

• https://cosol.jp/service/service008/

リモートDBAサービス

時間制コンサルティングサービス

時間制コンサルティングサービスは”必要な時に” ”必要な時間だけ”契約できる 時間契約型のコンサルティングサービスです。

• https://cosol.jp/service/service013/

時間制コンサルティングサービス