Nagios监控HAproxy插件--用shell自定义Nagios插件

最近用shell写了个监控haproxy状态的脚本,记录一下以备后用。

1、首先明确需求。我们需要什么功能,常规方式是怎么实现的,使用脚本又该怎么实现。
只需要监控5个状态:当前连接数Session rate下的Cur;错误状态Errors下的三种状态Req,Conn,Resp;服务状态Status。状态页面如图:

Nagios监控HAproxy插件--用shell自定义Nagios插件

那么如何用脚本的形式把这些展示出来呢?重要的是,如何让nagios能够获取到这些数据?这就是接下来需要做的事情。
获取这些数据有两种方法:其一,通过wget或者curl来访问状态页面,然后筛选数据;其二,通过sock来获取状态,然后筛选。我先采用第二种方式来获取数据。

从sock获取数据,需要安装socat这个软件,具体使用省略。

echo "show stat" | socat /var/lib/haproxy/stats stdio
#/var/lib/haproxy/stats是haproxy路径

可以看到以csv格式的状态

pxname,svname,qcur,qmax,scur,smax,slim,stot,bin,bout,dreq,dresp,ereq,econ,eresp,wretr,wredis,status,weight,act,bck,chkfail,chkdown,lastchg,downtime,qlimit,pid,iid,sid,throttle,lbtot,tracked,type,rate,rate_lim,rate_max,check_status,check_code,check_duration,hrsp_1xx,hrsp_2xx,hrsp_3xx,hrsp_4xx,hrsp_5xx,hrsp_other,hanafail,req_rate,req_rate_max,req_tot,cli_abrt,srv_abrt,
admin_status,FRONTEND,,,1,1,20480,31,12757,354568,0,0,0,,,,,OPEN,,,,,,,,,1,1,0,,,,0,1,0,10,,,,0,29,1,0,0,0,,1,10,31,,,
admin_status,BACKEND,0,0,0,0,20480,0,12757,354568,0,0,,0,0,0,0,UP,0,0,0,,0,773,0,,1,1,0,,0,,1,0,,0,,,,0,0,0,0,0,0,,,,,0,0,
http_80_in,FRONTEND,,,0,1,20480,4,348,848,0,0,0,,,,,OPEN,,,,,,,,,1,2,0,,,,0,0,0,1,,,,0,0,0,0,4,0,,0,1,4,,,
web,web1,0,0,0,0,,0,0,0,,0,,0,0,0,0,UP,1,1,0,0,0,773,0,,1,3,1,,0,,2,0,,0,L7OK,200,0,0,0,0,0,0,0,0,,,,0,0,
web,web2,0,0,0,0,,0,0,0,,0,,0,0,0,0,DOWN,2,1,0,0,1,771,771,,1,3,2,,0,,2,0,,0,L4TOUT,,1502,0,0,0,0,0,0,0,,,,0,0,
web,BACKEND,0,0,0,0,0,0,0,0,0,0,,0,0,0,0,UP,1,1,0,,0,773,0,,1,3,0,,0,,1,0,,0,,,,0,0,0,0,0,0,,,,,0,0,


需要的数据:当起连接数rate在第34域;err相关的ereq、econ、eresp在第13、14、15域;状态status在第18域。用awk筛选数据:

rate=`echo "show stat" | socat /var/lib/haproxy/stats stdio | awk -F, '$2=="web1" {print $34}'`
ereq=`echo "show stat" | socat /var/lib/haproxy/stats stdio | awk -F, '$2=="web1" {print $34}'`
econ=`echo "show stat" | socat /var/lib/haproxy/stats stdio | awk -F, '$2=="web1" {print $34}'`
eresp=`echo "show stat" | socat /var/lib/haproxy/stats stdio | awk -F, '$2=="web1" {print $34}'`
status=`echo "show stat" | socat /var/lib/haproxy/stats stdio | awk -F, '$2=="web1" {print $34}'`


数据现在已经可以获取了,接下来就要让nagios能够接受到数据。

2、了解插件规范。
nagios的插件规范有两点:
(1)、需要一个返回值来确定状态

0OK
1WARNING
2CRITICAL
3UNKNOWN


(2)、在报警处输出定义的说明,默认大小4K,见红框位置:

Nagios监控HAproxy插件--用shell自定义Nagios插件

 

了解了编写规范,现在就开始写脚本。

3、脚本实例

#########################################################################
# File Name: check_haproxy.sh
# Author: jc
# Created Time: 2014年03月01日 星期六 14时36分23秒
#########################################################################
#!/bin/bash
#定义返回状态
ST_OK=0
ST_WR=1
ST_CR=2
ST_UK=3
#sock的默认路径
sock_path=/var/lib/haproxy/stats
#默认检查sock是否存在
#sock_check=1
#帮助信息函数
print_help() {
    echo "  --sock|-s)"
    echo "    haproxy的sock路径,默认路径:/var/lib/haproxy/stats"
    echo "  -m/--mode)"
    echo "    haproxy的状态项,目前只支持:rate,ereq,econ,eresp,status"
#    echo "  -n/--no-check-sock)"
#    echo "    检查sock存在与否,1检查,0不检查"
    exit $ST_UK
}
#获取输入的选项
while test -n "$1"; do
    case "$1" in
        -help|-h)
        print_help
        exit $ST_UK
        ;;
        --sock|-s)
        sock=$2
        shift
        ;;
        --mode|-m)
        mode=$2
        shift
        ;;
        --no-sock-check|-n)
        sock_check=0
        ;;
        --hostname|-H)
        hostname=$2
        shift
        ;;
        --warning|-w)
        warning=$2
        shift
        ;;
        --critical|-c)
        critical=$2
        shift
        ;;
        *)
        echo "Unknown argument: $1"
        print_help
        exit $ST_UK
        ;;
  esac
  shift
done
#sock检测
#check_sock() {
#echo "show stat" | socat /var/lib/haproxy/stats stdio >/tmp/hap_sta.txt
#if [ -s "/tmp/hap_sta.txt" ]
#then
#        con=1
#else
#        con=2
#fi
#}
#获取数据
get_val() {
case $mode in
        rate)
                val=`echo "show stat" | socat $sock_path stdio | awk -F, '$2=="web1" {print $34}'`
                ;;
        ereq)
                val=`echo "show stat" | socat $sock_path stdio | awk -F, '$2=="web1" {print $13}'`
                if [ -z $val ]
            then
            val=0
            fi
            ;;
        econ)
                val=`echo "show stat" | socat $sock_path stdio | awk -F, '$2=="web1" {print $14}'`
                ;;
        eresp)
                val=`echo "show stat" | socat $sock_path stdio | awk -F, '$2=="web1" {print $15}'`
                ;;
        status)
                val=`echo "show stat" | socat $sock_path stdio | awk -F, '$2=="web1" {print $18}'`
                ;;
        *)
        echo "暂时不能检测此项,请重新输入"
        ;;
esac
}
#显示的文字信息
out_pr() {
output="haproxy is running. $mode's key is $val"
}
#开始执行
##检查sock是否能够连上
#if [ $sock_check = 1 ]
#then
#    check_sock
#    if [ "$con" = 2 ]
#    then
#        echo "ERR!!连接haproxy被拒绝,请确认服务已经开启,或者检查sock路径/权限是否正确!"
#        exit $ST_CR
#    fi
#fi
get_val
out_pr
#get_stat() {
if [ "$val" -ge "$warning" ] && [ "$val" -lt "$critical" ]
then
        echo "WARNING - $output"
        exit $ST_WR
elif [ "$val" -ge "$critical" ]
then
        echo "CRITICAL - $output"
        exit $ST_CR
else
        echo "OK - $output"
        exit $ST_OK
fi

脚本完成,先在命令行测试:

[root@webtest-250 libexec]# /opt/nagios/libexec/check_haproxy.sh -m rate -w 10 -c 20
OK - haproxy is running. rate's key is 0

注意,以下两步相当重要,如果不给nagios用户添加权限,在页面会看不到值,如Nagios监控HAproxy插件--用shell自定义Nagios插件
(1)、更改/etc/sudoers,把nagios启动用户添加进去

nagios ALL=(ALL) NOPASSWD:/usr/local/nagios/libexec/check_hap.sh

(2)、更改/etc/sudoers把这一行注释,否则在后台运行sudo会报错

#Defaults    requiretty

现在切换到nagios的用户执行就正确了。

HAproxy 的详细介绍:请点这里
HAproxy 的下载地址:请点这里

推荐阅读:

相关推荐