参考至http://www.smartmarmot.com/wiki/index.php?title=Orabbix#Requirements
产品说明
Orabbix是一个插件，它是与Zabbix 配合，对Oracle数据库提供多层监视、性能和可用性报告和度量，以及服务器性能指标。它提供了从大量Oracle实例获取数据的有效机制，并向Zabbix服务器提供监视和性能指标的信息。然后，您可以利用Zabbix的报告功能来收集所有数据，并为涉众提供图表和服务级别协议度量等分析。当前的发行版包含一组预定义的模板，这些模板结合了初始部署的警报和绘图功能。当然，你也可以根据自身需求和数据/监视需求来设计自己的监控。
它可以监控什么？
下面是一些orabbix监控的例子：
数据库的版本；
归档日志的趋势数据；
处于等待状态的事务（i.e Files I/O, single block read, multi-block read, direct path read, SQLNet Messages, Control file I/O, Log Write）；
命中率（(i.e Hit Ratio on Triggers, Tables/Procedures, SQL Area, Body）；
逻辑I/O（Server performance on Logical I/O of: Current Read, Consistent Read, Block Change）；
物理I/O（Redo Writes, Datafile Writes, Datafile Reads）；
PGA；
SGA（In particular; Fixed Buffer, Java Pool, Large Pool, Log Buffer, Shared Poolm Buffer Cache）；
共享池（Active Sessions, Inactive Sessions, System Sessions）；
数据库大小/数据库文件大小（DBSize size of database really used space and of Filesize）；
安装要求
zabbix server版本1.8以上；
Java Runtime Environment 6；
目前已知的成功测试了Oracle主机平台
RHEL5.X (CentOS 5.4 & 5.5)
Windows 2003 (with Java SE 1.6)
HP-UX 11.31
AIX 5.3
目前已知的测试Oracle版本
10g
10.2
注意：不需要为orabbix安装任何类型的客户端
假设
安装说明是基于对大多数 unix 部署(即RHEL / CentOS)的指令而创建的，如果你的环境比较特殊，需要做一些修改。
这个说明是基于俩台主机来的，一台zabbix服务器端，一台Oracle数据库。如果你打算监控zabbix服务器上的Oracle时，步骤是一样的，只需要对一些较小的连接信息进行修改。
这些步骤也包括你需要配置orabbix来监控一个新安装的或者安装配置好的Oracle数据库。安装步骤将为Zabbix用户提供所有表的访问权限，这将包括在执行时出现的任何用户表。如果你不希望Zabbix访问数据库中的特定表或资源，则需要根据要求设置拒绝Zabbix用户访问权限。详细信息请咨询您的DBA，因为这超出了这些说明的范围。
安装步骤（orabbix是安装在服务器端的）
在zabbix server 下载orabbix，地址：https://sourceforge.net/projects/orabbix/files/orabbix-1.2.3.zip/download 需要翻墙
解压到/opt/orabbix文件夹下； PS：可以是别的路径
复制/opt/orabbix/init.d/orabbix 到/etc/init.d/orabbix
给orabbix这个文件可执行权限；
/etc/init.d/orabbix
/opt/orabbix/run.sh
创建Oracle用户
为orabbix访问Oracle数据库创建一个用户（ZABBIX），可以使用一下命令：
CREATE USER ZABBIX
IDENTIFIED BY <REPLACE WITH PASSWORD>
DEFAULT TABLESPACE SYSTEM
TEMPORARY TABLESPACE TEMP
PROFILE DEFAULT
ACCOUNT UNLOCK;
– 2 Roles for ZABBIX
GRANT CONNECT TO ZABBIX;
GRANT RESOURCE TO ZABBIX;
ALTER USER ZABBIX DEFAULT ROLE ALL;
– 5 System Privileges for ZABBIX
GRANT SELECT ANY TABLE TO ZABBIX;
GRANT CREATE SESSION TO ZABBIX;
GRANT SELECT ANY DICTIONARY TO ZABBIX;
GRANT UNLIMITED TABLESPACE TO ZABBIX;
GRANT SELECT ANY DICTIONARY TO ZABBIX;
注意：
如果你想创建的这个用户权限最小，可以参看以下方案：
CREATE USER ZABBIX
IDENTIFIED BY
DEFAULT TABLESPACE USERS
TEMPORARY TABLESPACE TEMP
PROFILE DEFAULT
ACCOUNT UNLOCK;
GRANT ALTER SESSION TO ZABBIX;
GRANT CREATE SESSION TO ZABBIX;
GRANT CONNECT TO ZABBIX;
ALTER USER ZABBIX DEFAULT ROLE ALL;
GRANT SELECT ON V_$INSTANCE TO ZABBIX;
GRANT SELECT ON DBA_USERS TO ZABBIX;
GRANT SELECT ON V_$LOG_HISTORY TO ZABBIX;
GRANT SELECT ON V_$PARAMETER TO ZABBIX;
GRANT SELECT ON SYS.DBA_AUDIT_SESSION TO ZABBIX;
GRANT SELECT ON V_$LOCK TO ZABBIX;
GRANT SELECT ON DBA_REGISTRY TO ZABBIX;
GRANT SELECT ON V_$LIBRARYCACHE TO ZABBIX;
GRANT SELECT ON V_$SYSSTAT TO ZABBIX;
GRANT SELECT ON V_$PARAMETER TO ZABBIX;
GRANT SELECT ON V_$LATCH TO ZABBIX;
GRANT SELECT ON V_$PGASTAT TO ZABBIX;
GRANT SELECT ON V_$SGASTAT TO ZABBIX;
GRANT SELECT ON V_$LIBRARYCACHE TO ZABBIX;
GRANT SELECT ON V_$PROCESS TO ZABBIX;
GRANT SELECT ON DBA_DATA_FILES TO ZABBIX;
GRANT SELECT ON DBA_TEMP_FILES TO ZABBIX;
GRANT SELECT ON DBA_FREE_SPACE TO ZABBIX;
GRANT SELECT ON V_$SYSTEM_EVENT TO ZABBIX;
注意：
如果你使用的是Oracle 11g，你需要做以下操作放开ACL访问控制，否则在监控过程中有部分内容无法显示：
exec dbms_network_acl_admin.create_acl(acl => 'resolve.xml',description => 'resolve acl', principal =>'ZABBIX', is_grant => true, privilege => 'resolve');
exec dbms_network_acl_admin.assign_acl(acl => 'resolve.xml', host =>'*');
commit;
你可以运行以下命令来验证正确性：
select utl_inaddr.get_host_name('127.0.0.1') from dual;
（Redhat）将orabbix设置为开机自启动：
chkconfig --add orabbix
chkconfig --list #检查
在Zabbix中为您计划监视的DB实例创建一个主机条目，并导入在:/ opt/orabbix/ template中发现的模板
这一步可以参考zabbix官网：http://www.zabbix.com/documentation.php
orabbix配置文件
在/opt/orabbix/conf/ 目录下有个叫config.props.sample的文件，将这个文件复制并改名为config.props
]# mv config.props.sample config.props
配置文件如下：
#comma separed list of Zabbix servers
ZabbixServerList=ZabbixServer1,ZabbixServer2 #zabbixserver1、zabbixserver2定义zabbix服务器的名字，与下面的zabbixserver1和2对应
ZabbixServer1.Address=192.168.10.11 #上面定义的zabbixserver1的IP地址
ZabbixServer1.Port=10051 #zabbixserver1的端口
# ZabbixServer2.Address=IP_ADDRESS_OF_ZABBIX_SERVER #zabbixserver2默认是注销的，如果你有多个zabbixserver，选填这个
# ZabbixServer2.Port=PORT_OF_ZABBIX_SERVER
#pidFile
OrabbixDaemon.PidFile=./logs/orabbix.pid #Pid文件的位置
#frequency of item's refresh
OrabbixDaemon.Sleep=300 # 监控项的刷新间隔（不需修改）
#MaxThreadNumber should be >= than the number of your databases
OrabbixDaemon.MaxThreadNumber=100 #orabbix守护进程的最大线程数
#put here your databases in a comma separated list
DatabaseList=DB1,DB2,DB3 # 数据库列表（zabbix中的主机名必须用这个儿定义的名字）
#Configuration of Connection pool
#if not specified Orabbis is going to use default values (hardcoded)
#Maximum number of active connection inside pool
DatabaseList.MaxActive=10 # 连接池最大活动连接数（无需修改）
#The maximum number of milliseconds that the pool will wait
#(when there are no available connections) for a connection to be returned
#before throwing an exception, or <= 0 to wait indefinitely.
DatabaseList.MaxWait=100 #返回连接异常的等待时间，毫秒。可以定义为一个负值以表示不做限制
DatabaseList.MaxIdle=1 #最大空闲连接数，可以定义为一个负值以表示不做限制
#define here your connection string for each database
DB1.Url=jdbc:oracle:thin:@server.domain.example.com:<LISTENER_PORT>:DB1
DB1.User=zabbix
DB1.Password=9133
DB1是DatabaseList=DB1,DB2,DB3 上面这一项列出的名字
server.domain.example.com是你Oracle服务器的主机名或者IP地址（建议为IP地址）
<LISTENER_PORT>是你数据库的端口
DB1:是Oracle数据库的SID
下面的你在Oracle里创建的允许orabbix采集数据的账号和密码，DB1与上面保持一致
#Those values are optionals if not specified Orabbix is going to use the general values
DB1.MaxActive=10 #针对单独的数据库设置参数，上面的全局的，这个是单独的
DB1.MaxWait=100
DB1.MaxIdle=1
DB1.QueryListFile=./conf/query.props
DB2.Url=jdbc:oracle:thin:@server2.domain.example.com::DB2
DB2.User=zabbix
DB2.Password=zabbix_password
DB2.QueryListFile=./conf/query.props
DB3.Url=jdbc:oracle:thin:@server3.domain.example.com::DB3
DB3.User=zabbix
DB3.Password=zabbix_password
DB3.QueryListFile=./conf/query.props
配置文件补充
QueryListFile=/opt/orabbix/conf/query.props #查询文件的位置
<DBNAME>.QueryListFile=./confQueryTest.props #定义单个数据库的查询文件位置，可以使用相对路径
对于不同的数据库使用不同的查询文件，或者每个数据库都有一个查询文件池，这在不同的Oracle版本(如果有不同版本)或生产环境、测试环境、开发环境等不同环境下使用时有奇效。
<DB_NAME>.ExtraQueryListFile ==./confQueryTest_2.props
#官网是这样定义的：adds another custom query to the default query file.If there are duplicates the ExtraQueryListFile will override them
query.props查询文件
可以在这个文件中设置自定义查询项。比如你要监控公司一些业务逻辑之类的定制监控项
创建的每个查询必须有一个item名，必须是独一无二的。zabbix server会识别这个item，就像其他item一样，不能冲突。
QueryList=queryName1,queryName2,queryName3 #定义item名，以逗号分隔
customQueryItemName.Query=yourQueryHere #自定义查询语句结尾不要加封号
customQueryItemName.NoDataFound=none #定义无查询结果时的返回值（默认是none）
customQueryItemName.Period=<Express a period in minute> #自定义语句的执行周期，例如：数据库的版本
条件查询
customQueryItemName.ACTIVE=[true|false]
你可以定义一个查询返回值，来判断指定的查询语句是否要执行，如下：
archive.Query=select round( A.LOGS*B.AVG/1024/1024/10 ) \
from ( SELECT COUNT (*) LOGS FROM V$LOG_HISTORY WHERE \
FIRST_TIME >= (sysdate -10/60/24)) A, \
( SELECT Avg(BYTES) AVG, Count(1), Max(BYTES) Max_Bytes,Min(BYTES) Min_Bytes FROM v$log) B
archive.RaceConditionQuery=select value \
from \
v$parameter where name='log_archive_start'
archive.RaceConditionValue=FALSE
在上面的例子中，如果archive.RaceConditionQuery这个查询返回的值是archive.RaceConditionValue定义的值，则执行archive.Query查询语句，archive.RaceConditionValue这个值是TRUE时才查询，也就是只有当Oracle数据库处于归档模式时才执行归档日志查询。
<QueryName>.Trim=[true|false]
<QueryName>.AddSpaces=[true|false]
<QueryName>.ExcludeColumnsList=[1,2,3,..n]
<QueryName>.Period
<QUERY_NAME>.WhenNotAlive = <VALUE>
DefaultUser = <USERNAME>
DefaultPassword =<PASSWORD>
<QueryName>.ExtraQueryListFile =<VALUE>
<QUERY_NAME>.WhenNotAlive =<VALUE>
/opt/orabbix/conf/log4j.properties在这个文件中可以设置orabbix的日志格式，日志格式和apache的一样
i.e
如果您有两个主机RAC1和RAC2和一个实例RACINST，你可以在orabbix配置文件中这么写：
RACINST.Url=jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(HOST=RAC1.EXAMPLE.COM) \
(PORT=1521))(ADDRESS=(PROTOCOL=TCP)(HOST=RAC2.EXAMPLE.COM)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=RACINST)))
网友评论