Zabbix创建Oracle监控模板

Posted 2022-06-17 leohahah

如何自定义一个Oracle的监控模板？以oracle11.2为例，首先来梳理下oracle需要监控哪些指标：

1.一些常见的基础指标，诸如：实例状态、会话数、登陆失败次数、表空间使用率、asm磁盘组使用率等。

2.详细的oracle性能指标，诸如AWR Report Summary中列出来的很多指标，但其实很好获取的指标暂时可以想到的就是事务数和非Idle等待会话数。

所以总结下目前能轻易获取的指标只有以下几种：

• 数据库连通性  //暂时不建对应的监控项，懒
• 实例会话数
• 处于非空闲等待的会话数  --此指标可以扩散为处于不同种类等待的会话数,如library cache xxx,enq xxx等等。
• 当前事务数
• 登录失败次数
• 表空间使用率最高的表空间的使用率   //由于单独统计每个表空间的使用率需要带上表空间名，不适合作为numeric类型的返回值，因此我选择只统计使用率最高的那个，下一个指标同理
• 空余容量最少的表空间的空余容量
• ASM磁盘组容量监控

如何获取这些指标值？其实zabbix官网已经提供了很多模板（参考https://share.zabbix.com/databases/oracle），但是很多模板要么是只提供了模板未提供对应的command命令，要么是功能虽然很强大，但是要装一系列的其他组件（诸如python及其第三方包），要么是不熟悉oracle的搞出来的，对oracle一些指标的理解不够精细。总之我用起来很不爽，所以还是要自己造轮子，目标也很简单：用自带的sqlplus通过sql直接查询性能视图获得监控值。

步骤一：创建模板、application和监控项。

模板和application的创建就懒得演示了，在网页上操作就是一个起名的过程，模板的名字自定义为Oracle_Monitor，里边建一个名为oracle_session_waits的application专门用于统计各类会话等待事件。

Zabbix自带了8个模板的host group，其中Templates是其他7个host group的hosts元素集合。

在Zabbix中，host不仅仅指被监控的服务或主机，也可以是模板，为了更好地管理模板，我选择直接将新建的oracle监控模板加入Templates/Databases模板组中，默认的此host group下只有一个Template DB mysql的自带模板。

为了描述上述几个oracle监控指标，首先需要创建对应监控项（items）：

这些监控项的名字和key都是自定义的，只要标示明确即可。至此模板就都建完了，key type都是numerical的数字格式。

步骤二：准备工作。

为了访问oracle取得监测数据首先要建一个用户，我这里先建一个用户zabbix：

create user zabbix identified by "zabbix";
grant connect to zabbix;
grant select_catalog_role to zabbix;

步骤三：创建获取监控值的脚本

直接贴脚本：check_oracle.sh，这脚本是我根据自己的环境写的，如果有人想用请注意修改掉那些环境变量。

#!/bin/sh
export ORACLE_BASE=/u01/app/oracle
export ORACLE_HOME=$ORACLE_BASE/product/11.2.0/db_1
export TNS_ADMIN=$ORACLE_HOME/network/admin
export PATH=$ORACLE_HOME/bin:/usr/bin:/sbin/:$PATH
export LD_LIBRARY_PATH=$ORACLE_HOME/lib:/lib:/usr/lib
export CLASSPATH=$ORACLE_HOME/JRE:$ORACLE_HOME/jlib:$ORACLE_HOME/rdbms/jlib

#用法定义
#如果以后要新加监控项,那么除了需要在此处中新增提示之外，最重要的就是在etc/zabbix_10052/check_oracle_sql目录下新增对应监控项的SQL文件啦
if [ $# -ne 1 ];then
	echo "Usage:"
        echo "$0 TS_MAX_USEAGE|TS_MIN_SPACE|TRANS_COUNT|LOGIN_FAILS|ASM_MIN_SPACE|SESSION_COUNT|SESSION_NONE_IDLE|SESSION_LOG_FILE_SYNC|SESSION_GC|SESSION_ENQ|SESSION_LIBRARY_CACHE|SESSION_DIRECT_PATH|SESSION_LATCH"
	exit
fi
#ocmd命令定义
ocmd()
	#ocmd SQL_FILE [DBname] [DBuser] [DBpswd] [DBhost] [DBport]
	if [ -f $1 ];then
		SQL=`cat $1`
		else echo "SQL文件不存在!";exit
	fi
	DBname=oracle
	[ $2 ] && DBname=$2
	DBuser=zabbix
	[ $3 ] && DBuser=$3
	DBpswd=zabbix
	[ $4 ] && DBpswd=$4
	DBhost=`echo $HOSTNAME`
	[ $5 ] && DBhost=$5
	DBport=1521
	[ $6 ] && DBport=$6
result=`sqlplus -S $DBuser/$DBpswd@$DBhost:$DBport/$DBname <<EOF
set lines 200
set heading off feedback off pages 0 verify off echo off
$SQL
commit;
exit
EOF`
	echo $result

#获取监控数据
cd /etc/zabbix_10052/check_oracle_sql
ocmd $1.sql

 

 步骤四：编写获取监控指标的SQL。

如上脚本所示，所有的SQL文件都存在于/etc/zabbix_10052/check_oracle_sql目录下（至于为什么是zabbix_10052，是因为我这里已经有一套10050的agent在运行，为了把数据库监控分离出来我单独使用10052端口新开了个agent并新建了server）：

脚本一：获取会话数

SESSION_COUNT.sql

select count(*) from v$session;

脚本二：获取处于非空闲等待的会话数

SESSION_NONE_IDLE.sql

select count(*) from v$session where wait_class != ‘Idle‘;

SESSION_LOG_FILE_SYNC这些以SESSION开头的监控项的脚本和上述脚本类似，只需要将过滤条件改改就可以了：

select count(*) from v$session where event like ‘direct path%‘;
select count(*) from v$session where event like ‘enq%‘;
select count(*) from v$session where event like ‘gc%‘;
select count(*) from v$session where event like ‘latch%‘;
select count(*) from v$session where event like ‘library cache%‘;
select count(*) from v$session where event=‘log file sync‘;

 脚本三：事务数

TRANS_COUNT.sql

select count(*) from v$transaction;

 脚本四：登陆失败次数

LOGIN_FAILS.sql

select count(*) from dba_audit_trail where ACTION_NAME=‘LOGON‘ and RETURNCODE=1017;

dba_audit_trail视图是由sys.AUD$、sys.AUDIT_ACTIONS等几个表join出来的结果，建议为sys.AUD$的ACTION#,returncode字段创建bitmap索引（因为DB级别的审计这俩字段的可用值其实很少），否则数据库时间久了查起来会超级慢。

脚本五：表空间最大使用率

TS_MAX_USEAGE.sql

select 
    max(to_char(round(sum(f.file_used_size_MB)*100/sum(f.file_max_size_MB),2),‘990.99‘))
from
(select df.tablespace_name, 
        round(decode(df.AUTOEXTENSIBLE,‘NO‘,df.bytes/1024/1024,‘YES‘,df.maxbytes/1024/1024),2) file_max_size_MB, 
        round((df.bytes-nvl(fs.bytes,0))/1024/1024,2) file_used_size_MB
from dba_data_files df 
left join (select tablespace_name,file_id,sum(bytes) as bytes from dba_free_space group by tablespace_name,file_id) fs
on df.file_id=fs.file_id 
) f
group by f.tablespace_name;

脚本六：表空间最小容量

TS_MIN_SPACE.sql

select 
	min(sum(f.file_max_size_MB)-sum(f.file_used_size_MB))
from
(select df.tablespace_name, 
        round(decode(df.AUTOEXTENSIBLE,‘NO‘,df.bytes/1024/1024,‘YES‘,df.maxbytes/1024/1024),2) file_max_size_MB, 
        round((df.bytes-nvl(fs.bytes,0))/1024/1024,2) file_used_size_MB
from dba_data_files df 
left join (select tablespace_name,file_id,sum(bytes) as bytes from dba_free_space group by tablespace_name,file_id) fs
on df.file_id=fs.file_id 
-- where df.tablespace_name [not] in (‘‘,...)  //可以排除一些不需要监控的表空间防止误报，或者只对某些表空间进行报警
) f
group by f.tablespace_name;

脚本七：asm磁盘组容量监控

ASM_MIN_SPACE.sql

select min(free_mb) from v$asm_diskgroup where name !=‘OCRVOTE‘;

排除不需要监控的磁盘组，还可以改写为使用率的监控。

步骤四：agent配置文件新增UserParameter

#oracle monitoring
UserParameter=oracle.status[*],/etc/zabbix_10052/check_oracle.sh $1

想要添加其他监控项直接照上例添加SQL文件和UserParameter，然后server web端添加相应的item即可。

重要提示：

zabbix agent的各项监控指标获取都是用zabbix用户操作的，所以zabbix一定要有脚本的访问和执行权限，本例将脚本全放在了/etc/zabbix_10052目录下，所以需要注意此目录的访问权限和一些可执行文件的执行权限。

此外脚本内调用的各种命令和文件zabbix用户也要有权访问。

如果一切正常，最后在latest data中就可以看到监控值了，我的如下：

其他补充：

至此基本的oracle监控模板已经建好了，接下来只需要加上一些触发器和graphs等对象就算完善了，现在懒得加，有空再回来补。