变量定义文件,又称为资源文件,在些文件中定义变量,
以便由其他配置文件引用,如$$USER1$$
配置文件之间的关系
在nagios的配置过程中涉及到的几个定义有:主机、主机组,服务、服务组,联系人、联系人组,监控时间,监控命令等,从这些定义可以看出,nagios各个配置文件之间是互为关联,彼此引用的。
成功配置出一台nagios监控系统,必须要弄清楚每个配置文件之间依赖与被依赖的关系,最重要的有四点:
第一:定义监控哪些主机、主机组、服务和服务组;
第二:定义这个监控要用什么命令实现;
第三:定义监控的时间段;
第四:定义主机或服务出现问题时要通知的联系人和联系人组。
templates.cfg文件nagios主要用于监控主机资源以及服务,在nagios配置中称为对象,为了不必重复定义一些监控对象,Nagios引入了一个模板配置文件,将一些共性的属性定义成模板,以便于多次引用。这就是templates.cfg的作用。
详细介绍templates.cfg文件中每个参数的含义:
define contact{
name generic-contact 联系人名称
service_notification_period 24x7 当服务出现异常时,发送通知的时间段,这个时间段"24x7"在timeperiods.cfg文件中定义
host_notification_period 24x7 当主机出现异常时,发送通知的时间段,这个时间段"24x7"在timeperiods.cfg文件中定义
service_notification_options w,u,c,r 这个定义的是 通知可以被发出的情况 。w即warn,表示警告状态,u即unknown,表示不明状态; c即criticle,表示紧急状态,r即recover,表示恢复状态; 也就是在服务出现警告状态、未知状态、紧急状态和重新恢复状态时都发送通知给使用者。
host_notification_options d,u,r 定义主机在什么状态下需要发送通知给使用者,d即down,表示宕机状态; u即unreachable,表示不可到达状态,r即recovery,表示重新恢复状态。
service_notification_commands notify-service-by-email 服务故障时,发送通知的方式,可以是邮件和短信,这里发送的方式是邮件;其中 notify-service-by-email 在commands.cfg文件中定义。
host_notification_commands notify-host-by-email 主机故障时,发送通知的方式,可以是邮件和短信,这里发送的方式是邮件; 其中 notify-host-by-email 在commands.cfg文件中定义。
register 0 DONT REGISTER THIS DEFINITION - ITS NOT A REAL CONTACT, JUST A TEMPLATE!
}
define host{
name generic-host 主机名称,这里的主机名,并不是直接对应到真正机器的主机名; 乃是对应到在主机配置文件里所设定的主机名。
notifications_enabled 1 Host notifications are enabled
event_handler_enabled 1 Host event handler is enabled
flap_detection_enabled 1 Flap detection is enabled
failure_prediction_enabled 1 Failure prediction is enabled
process_perf_data 1 其值可以为0或1,其作用为是否启用Nagios的数据输出功能; 如果将此项赋值为1,那么Nagios就会将收集的数据写入某个文件中,以备提取。
retain_status_information 1 Retain status information across program restarts
retain_nonstatus_information 1 Retain non-status information across program restarts
notification_period 24x7 指定 发送通知 的时间段,也就是可以在什么时候发送通知给使用者。
register 0 DONT REGISTER THIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE!
}
define host{
name linux-server 主机名称
use generic-host use表示引用,也就是将主机generic-host的所有属性引用到linux-server中来; 在nagios配置中,很多情况下会用到引用。
check_period 24x7 这里的check_period告诉nagios检查主机的时间段
check_interval 5 nagios对主机的检查时间间隔,这里是5分钟。
retry_interval 1 重试检查时间间隔,单位是分钟。
max_check_attempts 10 nagios对主机的最大检查次数,也就是nagios在检查发现某主机异常时,并不马上判断为异常状况; 而是多试几次,因为有可能只是一时网络太拥挤,或是一些其他原因,让主机受到了一点影响; 这里的10就是最多试10次的意思。
check_command check-host-alive 指定检查主机状态的命令,其中 check-host-alive 在commands.cfg文件中定义。
notification_period 24x7 主机故障时,发送通知的时间范围,其中 workhours 在timeperiods.cfg中进行了定义
notification_interval 10 在主机出现异常后,故障一直没有解决,nagios再次对使用者发出通知的时间。单位是分钟; 如果你觉得,所有的事件只需要一次通知就够了,可以把这里的选项设为0
notification_options d,u,r 定义主机在什么状态下可以发送通知给使用者,d即down,表示宕机状态; u即unreachable,表示不可到达状态;r即recovery,表示重新恢复状态。
contact_groups ts 指定联系人组,这个 admins 在contacts.cfg文件中定义。
register 0 DONT REGISTER THIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE!
}
define host{
name windows-server The name of this host template
use generic-host Inherit default values from the generic-host template
check_period 24x7 By default, Windows servers are monitored round the clock
check_interval 5 Actively check the server every 5 minutes
retry_interval 1 Schedule host check retries at 1 minute intervals
max_check_attempts 10 Check each server 10 times (max)
check_command check-host-alive Default command to check if servers are "alive"
notification_period 24x7 Send notification out at any time - day or night
notification_interval 10 Resend notifications every 30 minutes
notification_options d,r Only send notifications for specific host states
contact_groups ts Notifications get sent to the admins by default
hostgroups windows-servers Host groups that Windows servers should be a member of
register 0 DONT REGISTER THIS - ITS JUST A TEMPLATE
}
define service{
name generic-service 定义一个服务名称
active_checks_enabled 1 Active service checks are enabled
passive_checks_enabled 1 Passive service checks are enabled/accepted
parallelize_check 1 Active service checks should be parallelized(disabling this can lead to major performance problems)
obsess_over_service 1 We should obsess over this service (if necessary)
check_freshness 0 Default is to NOT check service 'freshness'
notifications_enabled 1 Service notifications are enabled
event_handler_enabled 1 Service event handler is enabled
flap_detection_enabled 1 Flap detection is enabled
failure_prediction_enabled 1 Failure prediction is enabled
process_perf_data 1 Process performance data
retain_status_information 1 Retain status information across program restarts
retain_nonstatus_information 1 Retain non-status information across program restarts
is_volatile 0 The service is not volatile
check_period 24x7 这里的check_period告诉nagios检查服务的时间段。
max_check_attempts 3 nagios对服务的最大检查次数。
normal_check_interval 5 此选项是用来设置服务检查时间间隔,也就是说,nagios这一次检查和下一次检查之间所隔的时间; 这里是5分钟。
retry_check_interval 2 重试检查时间间隔,单位是分钟。
contact_groups ts 指定联系人组
notification_options w,u,c,r 这个定义的是 通知可以被发出的情况 。w即warn,表示警告状态;u即unknown,表示不明状态;c即criticle,表示紧急状态,r即recover,表示恢复状态;也就是在服务出现警告状态、未知状态、紧急状态和重新恢复后都发送通知给使用者
notification_interval 10 Re-notify about service problems every hour
notification_period 24x7 指定 发送通知 的时间段,也就是可以在什么时候发送通知给使用者。
register 0 DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!
}
define service{
name local-service The name of this service template
use generic-service Inherit default values from the generic-service definition
max_check_attempts 4 Re-check the service up to 4 times in order to determine its final (hard) state
normal_check_interval 5 Check the service every 5 minutes under normal conditions
retry_check_interval 1 Re-check the service every minute until a hard state can be determined
register 0 DONT REGISTER THIS DEFINITION - ITS NOT A REAL SERVICE, JUST A TEMPLATE!
}
resource.cfg文件resource.cfg是nagios的变量定义文件。其中,变量$$USER1$$指定了安装nagios插件的路径,如果把插件安装在了其它路径,只需在这里进行修改即可。需要注意的是,变量必须先定义,然后才能在其它配置文件中进行引用。
commands.cfg文件此文件默认是存在的,无需修改即可使用,当然如果有新的命令需要加入时,在此文件进行添加即可。
#notify-host-by-email命令的定义
define command{
command_name notify-host-by-email #命令名称,即定义了一个主机异常时发送邮件的命令。
command_line /usr/bin/printf "%b" "***** Nagios *****Notification Type: $$NOTIFICATIONTYPE$$Host: $$HOSTNAME$$State: $$HOSTSTATE$$Address: $$HOSTADDRESS$$Info: $$HOSTOUTPUT$$Date/Time: $$LONGDATETIME$$" | /bin/mail -s "** $$NOTIFICATIONTYPE$$ Host Alert: $$HOSTNAME$$ is $$HOSTSTATE$$ **" $$CONTACTEMAIL$$ #命令具体的执行方式。 -H $$HOSTADDRESS$$ 是定义目标主机的地址,这个地址在hosts.cfg文件中定义了。
}
#notify-service-by-email命令的定义
define command{
command_name notify-service-by-email #命令名称,即定义了一个服务异常时发送邮件的命令
command_line /usr/bin/printf "%b" "***** Nagios *****Notification Type: $$NOTIFICATIONTYPE$$Service: $$SERVICEDESC$$Host: $$HOSTALIAS$$Address: $$HOSTADDRESS$$State: $$SERVICESTATE$$Date/Time: $$LONGDATETIME$$Additional Info:$$SERVICEOUTPUT$$" | /bin/mail -s "** $$NOTIFICATIONTYPE$$ Service Alert: $$HOSTALIAS$$/$$SERVICEDESC$$ is $$SERVICESTATE$$ **" $$CONTACTEMAIL$$
}
#check-host-alive命令的定义
define command{
command_name check-host-alive #命令名称,用来检测主机状态。
command_line $$USER1$$/check_ping -H $$HOSTADDRESS$$ -w 3000.0,80% -c 5000.0,100% -p 5
# 这里的变量$$USER1$$在resource.cfg文件中进行定义,即$$USER1$$=/home/nagios/libexec;
# 那么check_ping的完整路径为/home/nagios/libexec/check_ping;
# -w 3000.0,80% 中 -w 说明后面的一对值对应的是 WARNING 状态, 80% 是其临界值。
# -c 5000.0,100% 中 -c 说明后面的一对值对应的是 CRITICAL , 100% 是其临界值。
# -p 1 说明每次探测发送一个包。
}
hosts.cfg文件此文件默认不存在,需要手动创建,hosts.cfg主要用来指定被监控的主机地址以及相关属性信息,根据实验目标配置如下:
define host{
use linux-server #引用主机linux-server的属性信息,linux-server主机在templates.cfg文件中进行了定义。
host_name Nagios-Linux #主机名
alias Nagios-Linux #主机别名
address 192.168.1.111 #被监控的主机地址,这个地址可以是ip,也可以是域名。
}
#定义一个主机组
define hostgroup{
hostgroup_name bsmart-servers #主机组名称,可以随意指定。
alias bsmart servers #主机组别名
members Nagios-Linux #主机组成员,其中 Nagios-Linux 就是上面定义的主机。
注意:在/home/nagios/etc/objects 下默认有localhost.cfg 和windows.cfg 这两个配置文件,localhost.cfg 文件是定义监控主机本身的,windows.cfg 文件是定义windows 主机的,其中包括了对host 和相关services 的定义。所以在本次实验中,将直接在localhost.cfg 中定义监控主机(Nagios-Server),在windows.cfg中定义windows 主机(Nagios-Windows)。根据自己的需要修改其中的相关配置,详细如下:
services.cfg文件文件默认也不存在,需要手动创建,services.cfg文件主要用于定义监控的服务和主机资源,例如监控http服务、ftp服务、主机磁盘空间、主机系统负载等等。Nagios-Server 和Nagios-Windows 相关服务已在相应的配置文件中定义,所以这里只需要定义Nagios-Linux 相关服务即可,这里只定义一个检测是否存活的服务来验证配置文件的正确性,其他服务的定义将在后面讲到。
define service{
use local-service 引用local-service服务的属性值,local-service在templates.cfg文件中进行了定义。
host_name Nagios-Linux 指定要监控哪个主机上的服务, Nagios-Server 在hosts.cfg文件中进行了定义。
service_description check-host-alive 对监控服务内容的描述,以供维护人员参考。
check_command check-host-alive 指定检查的命令。
}
contacts.cfg文件contacts.cfg是一个定义联系人和联系人组的配置文件,当监控的主机或者服务出现故障,nagios会通过指定的通知方式(邮件或者短信)将信息发给这里指定的联系人或者使用者。
define contact{
contact_name wangjian 联系人的名称,这个地方不要有空格
use generic-contact 引用generic-contact的属性信息,其中 generic-contact 在templates.cfg文件中进行定义
alias Nagios Admin 联系人别名
email wangjian10@asiainfo.com
}
define contactgroup{
contactgroup_name shwlan 联系人组的名称,同样不能空格
alias Technical Support #联系人组描述
members wangjian 联系人组成员,其中 david 就是上面定义的联系人,如果有多个联系人则以逗号相隔
}
timeperiods.cfg文件此文件用于定义监控的时间段
define timeperiod{
timeperiod_name 24x7 时间段的名称,这个地方不要有空格
alias 24 Hours A Day, 7 Days A Week
sunday 00:00-24:00
monday 00:00-24:00
tuesday 00:00-24:00
wednesday 00:00-24:00
thursday 00:00-24:00
friday 00:00-24:00
saturday 00:00-24:00
}
#下面是定义一个名为workhours的时间段,即工作时间段。
define timeperiod{
timeperiod_name workhours
alias Normal Work Hours
monday 09:00-17:00
tuesday 09:00-17:00
wednesday 09:00-17:00
thursday 09:00-17:00
friday 09:00-17:00
}
cgi.cfg文件此文件用来控制相关cgi脚本,如果想在nagios的web监控界面执行cgi脚本,例如重启nagios进程、关闭nagios通知、停止nagios主机检测等,这时就需要配置cgi.cfg文件了。
由于nagios的web监控界面验证用户为wangjian,所以只需在cgi.cfg文件中添加此用户的执行权限就可以了,需要修改的配置信息如下:
default_user_name=wangjian
authorized_for_system_information=nagiosadmin,wangjian
authorized_for_configuration_information=nagiosadmin,wangjian
authorized_for_system_commands=wangjian
authorized_for_all_services=nagiosadmin,wangjian
authorized_for_all_hosts=nagiosadmin,wangjian
authorized_for_all_service_commands=nagiosadmin,wangjian
authorized_for_all_host_commands=nagiosadmin,wangjian
nagios.cfg文件nagios.cfg默认的路径为/home/nagios/etc/nagios.cfg,是nagios的核心配置文件,所有的对象配置文件都必须在这个文件中进行定义才能发挥其作用,这里只需将对象配置文件在Nagios.cfg文件中进行引用即可。
log_file=/home/nagios/var/nagios.log # 定义nagios日志文件的路径
cfg_file=/home/nagios/etc/objects/commands.cfg # cfg_file 变量用来引用对象配置文件,如果有更多的对象配置文件,在这里依次添加即可。
cfg_file=/home/nagios/etc/objects/contacts.cfg
cfg_file=/home/nagios/etc/objects/hosts.cfg
cfg_file=/home/nagios/etc/objects/services.cfg
cfg_file=/home/nagios/etc/objects/timeperiods.cfg
cfg_file=/home/nagios/etc/objects/templates.cfg
cfg_file=/home/nagios/etc/objects/localhost.cfg # 本机配置文件
cfg_file=/home/nagios/etc/objects/windows.cfg # windows 主机配置文件
object_cache_file=/home/nagios/var/objects.cache # 该变量用于指定一个 所有对象配置文件 的副本文件,或者叫对象缓冲文件
precached_object_file=/home/nagios/var/objects.precache
resource_file=/home/nagios/etc/resource.cfg # 该变量用于指定nagios资源文件的路径,可以在nagios.cfg中定义多个资源文件。
status_file=/home/nagios/var/status.dat # 该变量用于定义一个状态文件,此文件用于保存nagios的当前状态、注释和宕机信息等。
status_update_interval=10 # 该变量用于定义状态文件(即status.dat)的更新时间间隔,单位是秒,最小更新间隔是1秒。
nagios_user=nagios # 该变量指定了Nagios进程使用哪个用户运行。
nagios_group=nagios # 该变量用于指定Nagios使用哪个用户组运行。
check_external_commands=1 # 该变量用于设置是否允许nagios在web监控界面运行cgi命令;
# 也就是是否允许nagios在web界面下执行重启nagios、停止主机/服务检查等操作;
# 1 为运行, 0 为不允许。
command_check_interval=10s # 该变量用于设置nagios对外部命令检测的时间间隔,如果指定了一个数字加一个"s"(如10s);
# 那么外部检测命令的间隔是这个数值以秒为单位的时间间隔;
# 如果没有用"s",那么外部检测命令的间隔是以这个数值的 时间单位 的时间间隔。
interval_length=60 # 该变量指定了nagios的时间单位,默认值是60秒,也就是1分钟
# 即在nagios配置中所有的时间单位都是分钟。
验证Nagios 配置文件的正确性
/home/nagios/bin/nagios -v /home/nagios/etc/nagios.cfg
Nagios提供的这个验证功能非常有用,在错误信息中通常会打印出错误的配置文件以及文件中的哪一行,这使得nagios的配置变得非常容易,报警信息通常是可以忽略的,因为一般那些只是建议性的
Nagios的启动与停止1、 启动Nagios
通过初始化脚本启动nagios
/etc/init.d/nagios start
or
service nagios start
手工方式启动nagios
通过nagios命令的 -d 参数来启动nagios守护进程:
/home/nagios/bin/nagios -d /home/nagios/etc/nagios.cfg
2、 重启Nagios
当修改了配置文件让其生效时,需要重启/重载Nagios服务。
a. 通过初始化脚本来重启nagios
/etc/init.d/nagios reload
or
/etc/init.d/nagios restart
or
service nagios restart
3、停止Nagios
通过初始化脚本关闭nagios服务
/etc/init.d/nagios stop
or
service nagios stop
Nagios 命令使用方法Nagios安装完成后,libexec文件夹中存放所有命令,可以通过命令名 -h查看它的用法
如./check_tcp -h
check_tcp:监控TCP服务端口用法:check-tcp -H host -p port [-w warning time ] [ -c critical time ] [-s send string ]
check_tcp -H 192.168.1.2 -p 80 检测主机的http服务
command.cfg 里 command_line $$USER1$$/check_tcp -H $$HOSTADDRESS$$ -p $$ARG1$$ $$ARG2$$ 中,-p 后$$ARG1$$ $$ARG2$$ 表示在 host.cfg 配置文件中 check_tcp 可以跟两个端口参数,比如:check_tcp!20!21
check_disk:监控硬盘空间command_line $$USER1$$/check_disk -w $$ARG1$$ -c $$ARG2$$ -p $$ARG3$$
格式:check_disk -w 低限% -c 低限% -p 磁盘设备文件或则分区文件的绝对路径
-w, --warning=PERCENT%
设定告警通知百分比数,空间低于该百分比则发出告警通知。
-c, --critical=PERCENT%
设定严重告警通知百分比数,空间低于该百分比则发出严重告警通知。
-p, --path=PATH, --partition=PARTITION
指定磁盘设备文件或则分区文件的绝对路径。
check_ping:监控pingcommand_line $$USER1$$/check_ping -H $$HOSTADDRESS$$ -w $$ARG1$$ -c $$ARG2$$ -p 5
Usage: check_ping -H host_address -w wrta , wpl % -c crta , cpl %
[-p packets] [-t timeout] [-L] [-4|-6]
具体如下:
-H 主机地址
-w WARNING 状态: 响应时间(毫秒),丢包率 (%)阀值
-c CRITICAL状态: 响应时间(毫秒),丢包率 (%)阀值
-p 发送的包数 默认5个包
-t 超时时间 默认10秒
-4|-6 使用ipv4|ipv6 地址 默认ipv4
./check_procs -h查看check_procs的用法。以下是几个sampler。
Examples:
check_procs -w 2:2 -c 2:1024 -C portsentry
Warning if not two processes with command name portsentry.
Critical if 2 or 1024 processes
check_procs -w 10 -a /usr/local/bin/perl -u root
Warning alert if 10 processes with command arguments containing
/usr/local/bin/perl and owned by root
check_procs -w 50000 -c 100000 metric=VSZ
Alert if vsz of any processes over 50K or 100K
check_procs -w 10 -c 20 metric=CPU
Alert if cpu of any processes over 10%% or 20%%
自定义脚本
#!/bin/sh# check_udpportSTAT_OK=0STAT_WARNING=1STAT_CRITICAL=2STAT_UNKNOWN=3IP=$$1if [ -z $${IP} ];thenecho "IP is null"exit $$STAT_WARNINGPORT=$$2if [ -z $${PORT} ];thenecho "Port is null"exit $$STAT_WARNINGLISTEN_NUM=`/usr/bin/nc -u -w 1 $${IP} -z $${PORT}| wc -l`if [ $${LISTEN_NUM} -eq 0 ];thenecho "CRITICAL.$${IP} UDP port $${PORT} listen number is $${LISTEN_NUM},please check."exit $$STAT_CRITICALecho "OK.$${IP} UDP port $${PORT} is running."exit $$STAT_OK脚本使用方法:./check_udp ip port
例:./check_udp 127.0.0.1 1645
将此脚本加入commands.cfg 文件中
# 'check_udp' command definition
define command{
command_name check_udp
command_line $$USER1$$/shell/check_udp $$HOSTADDRESS$$ $$ARG1$$
}
在 services.cfg 文件中加入监控主机的udp端口
define service{
use local-service
host_name SV22-HSS22-01
service_description Udp_radius_1645
check_command check_udp!1645
}
define service{
use local-service
host_name SV22-HSS2-02
service_description Tcp_radius_1646
check_command check_udp!1646
}
内存监控脚本(nagios客户端部署)#!/bin/bashSTAT_OK=0STAT_WARNING=1STAT_CRITICAL=2STAT_UNKNOWN=3total_mem=`free -m |awk 'NR==2{print $$2}'`used_mem=`free -m |awk 'NR==3{print $$3}'` #取的是系统真正用掉的内存free_mem=`free -m |awk 'NR==3{print $$4}'` #取的是free+cache的内存use_per=`echo "scale=2;$$used_mem/$$total_mem"|bc|sed 's/^.//g'`help() { echo "USAGE:`basename $$0` [-w] used percent [-c] used percent [-h]" exit -1if [ $$# -lt 1 ] then # 如果参数小于1个 helpwhile getopts ":w:c:h" opt case $$opt in w) warning=$$OPTARG c) critical=$$OPTARG h) help ?) unkown=$$OPTARG echo "error,plase check for help,USAGE:./`basename $$0` -h" exit $$STAT_UNKNOWN esacif [ $$use_per -lt $$warning ];then echo "OK - total:$$total_mem MB,used:$$used_mem MB,free:$$free_mem MB" exit $$STAT_OK elif [ $$use_per -ge $$warning ] [ $$use_per -lt $$critical ];then echo "WARNING - total:$$total_mem MB,used:$$used_mem MB,free:$$free_mem MB" exit $$STAT_WARNING else echo "CRITICAL - total:$$total_mem MB,used:$$used_mem MB,free:$$free_mem MB" exit $$STAT_CRITICAL脚本使用方法:check_mem [-w] used percent [-c] used percent [-h]
例:./check_mem -w 80 -c 90
配置文件nrpe.cfg加入
command[check_mem]=/home/nagios/libexec/shell/check_mem -w 80 -c 90
红色部分是命令名,也就是check_nrpe 的-c 参数可以接的内容,等号 = 后面是实际执行的插件程序
Nagios服务端commands.cfg 文件中存在如下内容
# 'check_nrpe' command definition
define command{
command_name check_nrpe
command_line $$USER1$$/check_nrpe -H $$HOSTADDRESS$$ -c $$ARG1$$
}
在 services.cfg 文件中加入监控主机的内存监控
define service{
use local-service
host_name SV46-HSS22
service_description mem
check_command check_nrpe!check_mem
}