pnp4nagios的安装
(1)安装
#tar -zxvf php4nagios-*.tar.gz
#cd php4nagios
#./configure --with-nagios-user=nagios --with-nagios-group=nagios (如果单独编译安装的rrdtoool,则使用--with-rrdtool=/usr/local/rrdtool-1.2.xx/bin/rrdtool这样的形式)
#make all
#make install
#make install-webconf
#make install-config
#make install-init
(使用这条命令替换所有的make命令, make fullinstall)
#service httpd restart
(2)配置
pnp4nagios有三种模式,配置方法分别如下
Synchronous Mode:
#vi /usr/local/nagios/etc/nagios.cfg
process_performance_data=1
enable_environment_macros=1
service_perfdata_command=process-service-perfdata
host_perfdata_command=process-host-perfdata
#vi /usr/local/nagios/etc/command.cfg
define command {
command_name process-service-perfdata
command_line /usr/local/pnp4nagios/libexec/process_perfdata.pl
}
define command {
command_name process-host-perfdata
command_line /usr/local/pnp4nagios/libexec/process_perfdata.pl -d HOSTPERFDATA
}
Bulk Mode:
#vi /usr/local/nagios/etc/nagios.cfg
process_performance_data=1
service_perfdata_file=/usr/local/pnp4nagios/var/service-perfdata
service_perfdata_file_template=DATATYPE::SERVICEPERFDATA\tTIMET::$TIMET$\tHOSTNAME::$HOSTNAME$\tSERVICEDESC::$SERVICEDESC$\tSERVICEPERFDATA::$SERVICEPERFDATA$\tSERVICECHECKCOMMAND::$SERVICECHECKCOMMAND$\tHOSTSTATE::$HOSTSTATE$\tHOSTSTATETYPE::$HOSTSTATETYPE$\tSERVICESTATE::$SERVICESTATE$\tSERVICESTATETYPE::$SERVICESTATETYPE$
service_perfdata_file_mode=a
service_perfdata_file_processing_interval=15
service_perfdata_file_processing_command=process-service-perfdata-file
host_perfdata_file=/usr/local/pnp4nagios/var/host-perfdata
host_perfdata_file_template=DATATYPE::HOSTPERFDATA\tTIMET::$TIMET$\tHOSTNAME::$HOSTNAME$\tHOSTPERFDATA::$HOSTPERFDATA$\tHOSTCHECKCOMMAND::$HOSTCHECKCOMMAND$\tHOSTSTATE::$HOSTSTATE$\tHOSTSTATETYPE::$HOSTSTATETYPE$
host_perfdata_file_mode=a
host_perfdata_file_processing_interval=15
host_perfdata_file_processing_command=process-host-perfdata-file
#vi /usr/local/nagios/etc/command.cfg
define command{
command_name process-service-perfdata-file
command_line /usr/local/pnp4nagios/libexec/process_perfdata.pl --bulk=/usr/local/pnp4nagios/var/service-perfdata
}
define command{
command_name process-host-perfdata-file
command_line /usr/local/pnp4nagios/libexec/process_perfdata.pl --bulk=/usr/local/pnp4nagios/var/host-perfdata
}
由于一次处理的性能数据比较多,有可能超时,可以更改etc/process_perfdata.cfg里的timeout时间。
Bulk Mode with NPCD: (我们现在使用的是这种方式)
更改方法同bulk mode,只有定义command部分不同:
#vi /usr/local/nagios/etc/command.cfg
define command{
command_name process-service-perfdata-file
command_line /bin/mv /usr/local/pnp4nagios/var/service-perfdata /usr/local/pnp4nagios/var/spool/service-perfdata.$TIMET$
}
define command{
command_name process-host-perfdata-file
command_line /bin/mv /usr/local/pnp4nagios/var/host-perfdata /usr/local/pnp4nagios/var/spool/host-perfdata.$TIMET$
}
#/usr/local/pnp4nagios/bin/npcd -d -f /usr/local/pnp4nagios/etc/npcd.cfg(确保npcd.cfg中设置了正确的spool目录)
(3)检查
第一次访问
将会执行一个必要部分的检查。如果看到“PHP magic_quotes_gpc is deprecated”,那么到php.ini文件中找到相应的设置并off掉。
调试日志
如果想产生调试日志,则更改process_perfdata.cfg中的
LOG_LEVEL=2,
一般情况下设置为0即可。
(4)排错verify_pnp_config
在运行pnp4nagios之前,我们最好运行一下scritps下的verify_pnp_config.pl来检查一下PNP的配置。
(5)将性能图集成到nagios的web页面中
更改定义主机和服务的模板文件:
define host {
name host-pnp
action_url /pnp4nagios/graph?host=$HOSTNAME$&srv=_HOST_
register 0
}
define service {
name srv-pnp
action_url /pnp4nagios/graph?host=$HOSTNAME$&srv=$SERVICEDESC$
register 0
}
再定义主机和服务时,添加上use行,来使用模板主机和服务:
define host{
use linux-server,host-pnp ; Name of host templates to use
; This host definition will inherit all variables that are defined
; in (or inherited by) the linux-server host template definition.
host_name localhost
alias localhost
address 127.0.0.1
}
define service{
use local-service,srv-pnp ; Name of service template to use
host_name localhost
service_description PING
check_command check_ping!100.0,20%!500.0,60%
}
你可以定义PNP集成到Nagios中,不需要点击任何图表就显示性能数据
1. 安装并运行PNP
2. 将contrib/ssi目录下的status-header.ssi拷贝到/usr/local/nagios/share/ssi/下。不要添加可执行权限。
3.更改相关的主机和服务模板设置:
define host {
name host-pnp
action_url /pnp4nagios/graph?host=$HOSTNAME$&srv=_HOST_' class='tips' rel='/pnp4nagios/popup?host=$HOSTNAME$&srv=_HOST_
register 0
}
define service {
name srv-pnp
action_url /pnp4nagios/graph?host=$HOSTNAME$&srv=$SERVICEDESC$' class='tips' rel='/pnp4nagios/popup?host=$HOSTNAME$&srv=$SERVICEDESC$
register 0
}
(6)设置PNP Web前端
通过更改etc/config.php来实现对PNP Web前端的更改。一般我们将自己的调整写在etc/config_local.php中,
但是如果这个文件不存在,则config.php可以作为一个参考。
(7)定义page
在/usr/local/pnp4nagios/etc/pages下创建*.cfg的文件,文件定义了要显示在一个页面上的性能数据:例如
define page {
use_regex 1 # 0 = use no regular expressions, 1 = use regular expressions
page_name test-page # page description
}
define graph {
host_name host1,host2,host3 #将显示host1,host2,host3三台主机的Current_Load服务性能图在test-page页面上
service_desc Current_Load
}
define graph {
host_name host1,host2 #将显示host1和host2上所有包含a或者o的服务的性能图到test-page页面上
service_desc a|o
}
(8)模板
模板存放在两个位置
share/template.dist 存放PNP包中的模板
share/template 自定义的模板存放位置
如果显示localhost上http服务的图形,那么PNP将会通过perfdata/localhost/http.xml文件中的TEMPLATE定义部分来决定使用什么模板(这个文件是自动生成的)。
PNP查找模板的顺序如下:
1. templates/check_http.php
2. templates.dist/check_http.php
3. templates/default.php
4. templates/default.php
创建自己的模板
模板必须遵循如下原则:
1.必须是有效的php语句
2.模板不能产生任何输出
3.队列$opt[]和$def[]必须被填充
另外一个需要注意的是,PNP4nagios是这样一个画图流程。
nagios里定义的命令名字 => pnp4nagios在etc/check_commands/ 目录下找跟命令名一样的 command_name.cfg => 这个配置文件中定义了模板的名字规则
个人总结:如果要创建某个nagios服务的画图模板,我们可以先确认这个服务的名称是什么,服务命令的名称是什么,然后到perfdata/hostname/下找到对应的“服务名.xml”,打开文件,看TEMPLATE定义部分的内容,这个内容便是这个相应检查命令默认使用的模板名称,模板后缀为php。
例如主机AAA的服务ALL_DISK,使用的命令是snmp_linux_alldisk_check.sh, 那么我们可以查看perfdata/AAA/ALL_DISK.xml文件,TEMPLATE部分的内容是snmp_linux_alldisk_check,则说明这个服务使用模板snmp_linux_alldisk_check.php,而你可以自己创建这个文件,并放在share/tmplates下,来实现自定义显示效果。
(9)NCPD的介绍
当nagios服务器运行大量的服务(即检查),高负载可能导致这样一个问题,定义的检查轮训是5分钟,也许它10分钟才执行。如果这时,nagios服务器再执行性能数据的采集,将会加重其检查的延迟,为了使nagios core摆脱性能数据的处理部分,我们使用ncpd。通过上面的配置部分,我们可以发现原本由nagios core处理性能数据的命令,变成了仅仅将性能数据拷贝到/usr/local/pnp4nagios/var/spool目录下,并打上时间戳,这个速度是非常快的。剩下性能数据处理工作就由ncpd进程来完成,更新到rrd文件中。
使用ncpd还有一个好处,防止性能数据的丢失,因为即使你的ncpd进程死掉活着重启之后没有启动ncpd,在/usr/local/pnp4nagios/var/spool目录下也保存着包含时间戳的数据,当重启ncpd进程时,它会对所有搜索到的数据进行处理,并更新到rrd文件中。
(10)nagios性能数据
nagios将插件输出中”|”号后的内容作为性能数据。性能数据格式如下:
'label'=value[UOM];[warn];[crit];[min];[max]
注意:
1. 多个性能数据之间用空格分割
2. label 可以包含任何字符
3. 如果label中包含空格、等号、或者单引号,则label需要用单引号来括起来
4. warn/crit/min/max可以为null值
5. 如果UOM单位是%,则min和max不需要再指定
6. UOM单位可以是如下: 默认空,表示数量(用于用户数、处理器数等)
s 表示秒(也可以用us,ms)
% 表示百分比
B 表示字节(也可以用KB,MB,TB,GB)
c 一个连续的计数(如:接口传输的字节数)