张 宇|Zabbix高级认证专家ZCP

• Zabbix5.0、6.0中文手册官方译者

你是否知道 Zabbix 有一个用于收集 Oracle 数据库指标的开箱即用模板？

使用此模板，我们可以使用 ODBC 无代理地收集数据库、表空间、ASM 和许多其他指标等数据。本文将指导如何为 Oracle 11.2、12.1、18.5 或 19.2 数据库服务器设置 ODBC 监控，将是部署 Oracle 数据库监控的完美指南。

1.下载 Instant 客户端和 SQLPlus

提供的命令适用于以下操作系统：CentOS 8、Oracle Linux 8 或 Rocky Linux。

首先我们要下载以下包：

oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64.rpm

oracle-instantclient19.12-sqlplus-19.12.0.0.0-1.x86_64.rpm

oracle-instantclient19.12-odbc-19.12.0.0.0-1.x86_64.rpm

我们在这里下载

Oracle 即时客户端——需要，建立与 Oracle 数据库的连接 SQLPlus——我们可以用来测试与 Oracle 数据库的连接的工具 Oracle ODBC 包——包含所需的 ODBC 驱动程序和配置脚本，以启用与 Oracle 数据库的 ODBC 连接

将包上传到 Zabbix 服务器（或代理，如果您希望在代理上监控您的 Oracle DB）并将其放置在：

/tmp/oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64.rpm
/tmp/oracle-instantclient19.12-sqlplus-19.12.0.0.0-1.x86_64.rpm
/tmp/oracle-instantclient19.12-odbc-19.12.0.0.0-1.x86_64.rpm

2.解决操作系统依赖

安装“libaio”和“libnsl”库：

dnf -y install libaio-devel libnsl

否则，我们会收到错误：

# rpm -ivh /tmp/oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64.rpm
error: Failed dependencies:
        libaio is needed by oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64
        libnsl.so.1()(64bit) is needed by oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64
# rpm -ivh /tmp/oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64.rpm
error: Failed dependencies:
        libnsl.so.1()(64bit) is needed by oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64

检查之前是否已在系统上部署了 Oracle 组件。下面的命令应该提供一个空的输出：

rpm -qa | grep oracle
ldconfig -p | grep oracle

3.安装 Oracle 客户端

rpm -ivh /tmp/oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64.rpm

确保安装了包“oracle-instantclient19.12-basic-19.12.0.0.0-1.x86_64”：

rpm -qa | grep oracle

4.LD配置

git.zabbix.com 上的官方 Oracle 模板页面讨论了为服务配置 Oracle ENV Usage 的方法。对于这种即时客户端的版本19.12，这是不REQUIRED营造“的/ etc / SYSCONFIG / ZABBIX服务器”的内容文件：

export ORACLE_HOME=/usr/lib/oracle/19.12/client64
export PATH=$PATH:$ORACLE_HOME/bin
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:/usr/lib64:/usr/lib:$ORACLE_HOME/bin
export TNS_ADMIN=$ORACLE_HOME/network/admin

虽然我们确实安装了 rpm 包，但 Oracle 19.12 客户端包确实在全局级别自动配置了 LD 路径——这意味着系统上的每个用户都可以使用 Oracle 即时客户端。我们可以看到 LD 路径已经配置在：

cat /etc/ld.so.conf.d/oracle-instantclient.conf

显示结果：

/usr/lib/oracle/19.12/client64/lib

为确保操作系统识别所需的 Oracle 库，我们可以运行：

ldconfig -p | grep oracle

正确的显示：

liboramysql19.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/liboramysql19.so
libocijdbc19.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libocijdbc19.so
libociei.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libociei.so
libocci.so.19.1 (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libocci.so.19.1
libnnz19.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libnnz19.so
libmql1.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libmql1.so
libipc1.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libipc1.so
libclntshcore.so.19.1 (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libclntshcore.so.19.1
libclntshcore.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libclntshcore.so
libclntsh.so.19.1 (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libclntsh.so.19.1
libclntsh.so (libc6,x86-64) => /usr/lib/oracle/19.12/client64/lib/libclntsh.so

**注意：**如果由于某种原因 ldconfig 命令显示到其他动态库的链接 - 那是我们可能必须为 Zabbix 服务器/代理创建单独的 ENV 文件，它将 Zabbix 应用程序链接到正确的动态库，如示例所示本节的开始。

5.检查Oracle服务端口是否可达

为我们以后省掉一些麻烦，首先检查与 Oracle 数据库主机的网络连接。检查是否可以在网络级别访问默认的 Oracle 端口。在本例中，我们将尝试连接到默认的 Oracle 数据库端口 1521。根据您的 Oracle 数据库正在侦听连接的端口，进行相应的调整。确保输出显示“已连接到 10.1.10.15:1521”：

nc -zv 10.1.10.15 1521

6.测试与 SQLPlus 的连接

在继续进行 ODBC 配置之前，我们可以模拟与 Oracle 数据库的连接。确保命令中使用的 Oracle 用户名和密码正确。对于此任务，我们首先需要安装 SQLPlus 包。：

rpm -ivh /tmp/oracle-instantclient19.12-sqlplus-19.12.0.0.0-1.x86_64.rpm

为了模拟连接，我们可以使用单行命令。在示例命令中，我使用用户名“system”和密码“oracle”通过端口“1521”访问 Oracle 数据库服务器“10.1.10.15”并连接到服务名称“xe”：

sqlplus64 'system/oracle@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=10.1.10.15)(PORT=1521)))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=xe)))'

在输出中我们可以看到：我们使用 19.12 客户端连接到 11.2 服务器：

SQL*Plus: Release 19.0.0.0.0 - Production on Mon Sep 6 13:47:36 2021
Version 19.12.0.0.0
Copyright (c) 1982, 2021, Oracle.  All rights reserved.
Connected to:
Oracle Database 11g Express Edition Release 11.2.0.2.0 - 64bit Production

**注意：**这为我们提供了有关 Oracle 即时客户端的额外提示——新版本的客户端向后兼容旧版本的 Oracle 数据库服务器。尽管这不适用于 Oracle 客户端/服务器的每个版本，但请先查看 Oracle 即时客户端文档。

7.ODBC 连接器

说到配置ODBC，我们先安装ODBC驱动管理器

dnf -y install unixODBC

现在我们可以看到我们有两个新文件——“/etc/odbc.ini”（可能是空的）和“/etc/odbcinst.ini”。文件“/etc/odbcinst.ini”描述了驱动程序关系。目前，当我们'grep'关键字'oracle'时没有安装oracle关系，当我们运行时输出为空：

grep -i oracle /etc/odbcinst.ini

我们的下一步是安装 Oracle ODBC 驱动程序包：

rpm -ivh /tmp/oracle-instantclient19.12-odbc-19.12.0.0.0-1.x86_64.rpm

'oracle-instantclient*-odbc' 包包含一个脚本，将自动更新 '/etc/odbcinst.ini' 配置：

cd /usr/lib/oracle/19.12/client64/bin
./odbc_update_ini.sh / /usr/lib/oracle/19.12/client64/lib

显示结果：

 *** ODBCINI environment variable not set,defaulting it to HOME directory!

现在当我们在屏幕上打印文件时：

cat /etc/odbcinst.ini

我们会看到在文件末尾添加了 Oracle 19 ODBC 驱动部分：

[Oracle 19 ODBC driver]
Description     = Oracle ODBC driver for Oracle 19
Driver          = /usr/lib/oracle/19.12/client64/lib/libsqora.so.19.1
Setup           =
FileUsage       =
CPTimeout       =
CPReuse         =

在执行“ldd”命令时，检查输出中是否没有错误很重要。这确保了依赖项得到满足且可访问，并且与库版本控制没有冲突：

ldd /usr/lib/oracle/19.12/client64/lib/libsqora.so.19.1

它会打印类似的东西：

linux-vdso.so.1 (0x00007fff121b5000)
libdl.so.2 => /lib64/libdl.so.2 (0x00007fb18601c000)
libm.so.6 => /lib64/libm.so.6 (0x00007fb185c9a000)
libpthread.so.0 => /lib64/libpthread.so.0 (0x00007fb185a7a000)
libnsl.so.1 => /lib64/libnsl.so.1 (0x00007fb185861000)
librt.so.1 => /lib64/librt.so.1 (0x00007fb185659000)
libaio.so.1 => /lib64/libaio.so.1 (0x00007fb185456000)
libresolv.so.2 => /lib64/libresolv.so.2 (0x00007fb18523f000)
libclntsh.so.19.1 => /usr/lib/oracle/19.12/client64/lib/libclntsh.so.19.1 (0x00007fb1810e6000)
libclntshcore.so.19.1 => /usr/lib/oracle/19.12/client64/lib/libclntshcore.so.19.1 (0x00007fb180b42000)
libodbcinst.so.2 => /lib64/libodbcinst.so.2 (0x00007fb18092c000)
libc.so.6 => /lib64/libc.so.6 (0x00007fb180567000)
/lib64/ld-linux-x86-64.so.2 (0x00007fb1864da000)
libnnz19.so => /usr/lib/oracle/19.12/client64/lib/libnnz19.so (0x00007fb17fdba000)
libltdl.so.7 => /lib64/libltdl.so.7 (0x00007fb17fbb0000)

当我们执行“odbc_update_ini.sh”脚本时，在“/root/.odbc.ini”中创建了一个新的DSN（数据源名称）文件。这是一个示例配置 ODBC 配置文件，它描述了此版本的 ODBC 驱动程序支持哪些设置。

让我们将此配置文件从用户目录移动到系统范围内可访问的位置：

cat /root/.odbc.ini | sudo tee -a /etc/odbc.ini

并从用户目录中完全删除该文件：

rm /root/.odbc.ini

这样，系统中的每个用户都将只使用这个 ODBC 配置文件。我们现在可以更改现有配置 – /etc/odbc.ini。我要突出显示从默认值更改的内容：

[Oracle11g]
AggregateSQLType = FLOAT
Application Attributes = T
Attributes = W
BatchAutocommitMode = IfAllSuccessful
BindAsFLOAT = F
CacheBufferSize = 20
CloseCursor = F
DisableDPM = F
DisableMTS = T
DisableRULEHint = T
Driver = Oracle 19 ODBC driver
DSN = Oracle11g
EXECSchemaOpt =
EXECSyntax = T
Failover = T
FailoverDelay = 10
FailoverRetryCount = 10
FetchBufferSize = 64000
ForceWCHAR = F
LobPrefetchSize = 8192
Lobs = T
Longs = T
MaxLargeData = 0
MaxTokenSize = 8192
MetadataIdDefault = F
QueryTimeout = T
ResultSets = T
ServerName = //10.1.10.15:1521/xe
SQLGetData extensions = F
SQLTranslateErrors = F
StatementCache = F
Translation DLL =
Translation Option = 0
UseOCIDescribeAny = F
UserID = system
Password = oracle

DSN – 数据源名称。应该匹配括号中的部分名称，例如：[Oracle11g] ServerName – Oracle 服务器地址 UserID – Oracle 用户名 Password – Oracle 用户密码

要从命令行测试连接，让我们使用 isql 命令行工具，该工具应该模拟 ODBC 连接，类似于 Zabbix 在收集指标时正在执行的操作：

isql -v Oracle11g

本示例中的 isql 命令从 odbc.ini 文件中选取 ODBC 设置（用户名、密码、服务器地址）。我们所要做的就是引用特定的 DSN – Oracle11g

另一方面，如果我们不想在文件系统 (/etc/odbc.ini) 上保留密码，我们可以删除“UserID”和“Password”行。然后我们可以测试 ODBC 连接：

isql -v Oracle11g 'system' 'oracle'

如果连接成功，它应该打印：这就是 ODBC 配置！现在我们应该可以在 Zabbix 中应用 Oracle by ODBC 模板了

+---------------------------------------+
| Connected!                                        |
|                                                           |
| sql-statement                                    |
| help [tablename]                               |
| quit                                                    |
|                                                           |
+---------------------------------------+
SQL>

不要忘记，我们还需要提供必要的 Oracle 凭证来开始收集 Oracle 数据库指标：

在这篇博文中学到的经验教训可以很容易地应用于一般的 ODBC 监控和故障排除，而不仅仅是 Oracle。如果您有任何问题或希望分享您在 ODBC 或 Oracle 数据库监控方面的经验——欢迎投稿分享，有偿！

-------------- --------------

第1场Zabbix6.0ZCU培训报名开启！

K8s、API、日志、prometheus，下半年课表更新！扫码学习！

往期推荐

Z投稿|Zabbix如何通过ODBC对接Oracle获取相关数据?

案例|光大银行如何解决传统监控痛点，打造一体化监控平台？

Zabbix全年在线课录屏

PDF手册|1666页 Zabbix6.0官方中文 操作手册PDF下载！

扫一扫｜加入技术交流群

微信号｜17502189550

备注“使用Zabbix年限+企业+姓名”

5000+用户已加入！

一个人走得快，一群人走得远