Nagios学习笔记之（三）配置详解

zhufeng518

　　Nagios学习笔记之（三）配置详解



前言：

上篇先实现的监控部署，就是想先搭建起来，有点小成就，现在再来看配置文件中的详解。只有把其中配置文件中的联系都理解清楚了，才能方便日后自己自定义的检测。Nagios的配置文件还是有其鲜明的特点的。

网上也有很多零零闪闪的配置讲解，但大多都不够详解，此篇为自己整理，当然也参考了网络上的信息，有配置的解释还有自己的一些备注，可能还有很多不完善的地方，后续会慢慢补充，希望看的人能看懂，还有就是自己以后能看懂，呵呵。

好了，不多说了，开始！



一、目录层次：

Nagios以及其插件，安装并配置好了以后，目录层次如下：

• bin              #Nagios执行程序所在目录，包括nagios、npc、nrpe等；
  
• etc              #Nagios配置文件位置，重点；
  
• libexec          #Nagios插件目录，里面有具体监控的各种插件，重点；
  
• sbin             #Nagios Cgi文件所在目录，也就是执行外部命令所需文件所在的目录；
  
• share            #Nagios网页文件所在的目录，也就是web页面给我们展示的文件；
  
• include          #Nagioscgi文件的外部调用；
  
• var              #Nagios日志文件、spid 等文件所在的目录。
  

二、配置文件概览：

Nagios所有的配置文件以cfg为结尾，在默认装好以后会在etc/下生成一些，我们来逐个看下：

• etc/nagios.cfg         #Nagios主配置文件，所有的cfg文件（外部调用除外）必须都在此文件中引用才能生效；
  
• etc/resource.cfg       #定义$USER1$变量，设置插件路径；
  
• etc/nrpe.cfg           #定义nrpe检测命令的文件，在command中引用；
  
• etc/objects下：
  
•     commands.cfg    #定义命令执行的文件，比如check_tcp、check_local_disk等，由后面定义服务的配置文件来引用；
  
•     contacts.cfg    #定义联系人的文件，比如服务down了通知的对象；
  
•     localhost.cfg   #定义本机的监控条目，默认生成；
  
•     printer.cfg     #定义打印机的文件，默认未启用，在生产环境中意义不大；
  
•     switch.cfg      #定义监控路由器和交换机的配置文件，默认未启用；
  
•     templates.cfg   #定义服务类型的文件，样本文件，比如定义的linux-server就是在此文件中预先定义好；
  
•     timeperiods.cfg #定义要监控时间段文件，比如24x7，workhours等；
  
•     windows.cfg     #定义监控Windows的文件，默认未启用。
  

备注：这些文件的名字不是一定的，只要里面的内容正确就可以，Nagios可以自动识别，比如你把commands.cfg和localhost.cfg的文件名互换，都是没有问题的。



三、各配置文件详解：（考虑篇幅，只列举部分）

1.etc/nagios.cfg（主配置文件）

• log_file=/usr/local/nagios/var/nagios.log                        
  
• # 这个变量用于设定Nagios在何处创建其日志文件。
  
• # OBJECT CONFIGURATION FILE(S)
  
• # 对象的配置文件
  
• # 可以指定单个对象的配置文件, 如下所示：
  
• cfg_file=/usr/local/nagios/etc/objects/commands.cfg   
  
• #定义其命令文件
  
• cfg_file=/usr/local/nagios/etc/objects/contacts.cfg      
  
• #定义联系人文件
  
• cfg_file=/usr/local/nagios/etc/objects/timeperiods.cfg  
  
• #定义时间段文件
  
• cfg_file=/usr/local/nagios/etc/objects/templates.cfg      
  
• #定义样本文件
  
• cfg_file=/usr/local/nagios/etc/objects/localhost.cfg      
  
• # 定义监测本地（ Linux ）主机
  
• 
  
• #cfg_file=/usr/local/nagios/etc/objects/windows.cfg     
  
• # 定义监测（ windows ）主机
  
• 
  
• #cfg_file=/usr/local/nagios/etc/objects/switch.cfg         
  
• # 定义监测路由器或交换机
  
•   
  
• #cfg_file=/usr/local/nagios/etc/objects/printer.cfg         
  
• # 定义监测打印机
  
•   
  
• # 也可以告诉Nagios处理所有配置文件（带有.cfg扩展名）在特定的目录使用cfg_dir指令如下所示：
  
• #cfg_dir=/usr/local/nagios/etc/servers
  
• #cfg_dir=/usr/local/nagios/etc/printers
  
• #cfg_dir=/usr/local/nagios/etc/switches
  
• #cfg_dir=/usr/local/nagios/etc/routers
  

总结：配置文件里的变量:

日志文件：

格式：    log_file=

样例：    log_file=/usr/local/nagios/var/nagios.log




说明：

这个变量用于设定Nagios在何处创建其日志文件。它应该是你主配置文件里面的第一个变量，当Nagios找到你配置文件并发现配置里有错误时会向该文件中写入错误信息。如果你使能了日志回滚，Nagios将在每小时、每天、每周或每月对日志进行回滚。




对象配置文件：

格式：    cfg_file=

样例：

cfg_file=/usr/local/nagios/etc/hosts.cfg

cfg_file=/usr/local/nagios/etc/servers.cfg

cfg_file=/usr/local/nagios/etc/commands.cfg




说明：

该变量用于指定一个包含有将用于Nagios监控对象的对象配置文件。对象配置文件中包括有主机、主机组、联系人、联系人组、服务、命令等等对象的定义。配置信息可以切分为多个文件并且用cfg_file=语句来指向每个待处理的配置文件.




对象配置目录:

格式：    cfg_dir=

样例：

cfg_dir=/usr/local/nagios/etc/commands

cfg_dir=/usr/local/nagios/etc/servers

cfg_dir=/usr/local/nagios/etc/hosts




说明：

该变量用于指定一个目录，目录里包含有将用于Nagios监控对象的对象配置文件。所有的在这个目录下的且以.cfg为扩展名的文件将被作为配置文件来处理。另外，Nagios将会递归该目录下的子目录并处理其子目录下的全部配置文件。你可以把配置放入不同的目录并且用cfg_dir=语句来指向每个待处理的目录。



2.etc/objects/commands.cfg（命令配置文件）

• #定义通知的方式，主机发生故障通知和服务发送故障通知
  
• define command{
  
•         command_name    notify-host-by-email
  
•         command_line    /usr/bin/printf "%b" "***** Nagios *****\n\nNotification Type: $NOTIFICATIONTYPE$\nHost: $HOSTNAME$\nState: $HOSTSTATE$\nAddress: $HOSTADDRESS$\nInfo: $H
  
• OSTOUTPUT$\n\nDate/Time: $LONGDATETIME$\n" | /bin/mail -s "** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **" $CONTACTEMAIL$
  
•         }
  
• #定义通知的方式，服务发生故障通知和服务发送故障通知
  
• # 'notify-service-by-email' command definition
  
• define command{
  
•         command_name    notify-service-by-email
  
•         command_line    /usr/bin/printf "%b" "***** Nagios *****\n\nNotification Type: $NOTIFICATIONTYPE$\n\nService: $SERVICEDESC$\nHost: $HOSTALIAS$\nAddress: $HOSTADDRESS$\nS
  
• tate: $SERVICESTATE$\n\nDate/Time: $LONGDATETIME$\n\nAdditional Info:\n\n$SERVICEOUTPUT$\n" | /bin/mail -s "** $NOTIFICATIONTYPE$ Service Alert: $HOSTALIAS$/$SERVICEDESC$ is $SE
  
• RVICESTATE$ **" $CONTACTEMAIL$
  
•         }
  
• #定义检测主机是否存活的命令，command_name是最后在服务中的引用名，而它是调用的check_ping命令来实现的
  
• define command{
  
•         command_name    check-host-alive
  
•         command_line    $USER1$/check_ping -H $HOSTADDRESS$ -w 3000.0,80% -c 5000.0,100% -p 5
  
•         }
  
• #定义检测主机cpu负载的命令
  
• define command{
  
•         command_name    check_local_load
  
•         command_line    $USER1$/check_load -w $ARG1$ -c $ARG2$
  
•         }
  
• #定义检测主机进程的命令
  
• define command{
  
•         command_name    check_local_procs
  
•         command_line    $USER1$/check_procs -w $ARG1$ -c $ARG2$ -s $ARG3$
  
•         ｝
  
• #定义检测主机tcp端口的命令
  
• define command{
  
•         command_name    check_tcp
  
•         command_line    $USER1$/check_tcp -H $HOSTADDRESS$ -p $ARG1$ $ARG2$
  
•         }
  

总结：

命令配置文件：

格式：   

define command{

    command_name    命令名

    command_line       命令调用的实际插件路径以及阀值

    ｝

样例：

cfg_file=/usr/local/nagios/etc/hosts.cfg

cfg_file=/usr/local/nagios/etc/servers.cfg

cfg_file=/usr/local/nagios/etc/commands.cfg




说明：

该变量用于指定一个包含有将用于Nagios监控命令的配置文件。对象配置文件中包括有命令名以及实际插件路径以及阀值的定义。



3./etc/objects/templates.cfg（样本配置文件）

• 此定义的为类，也就是日后定义主机或者服务时指定的name引用
  
• define service{
  
•         name                            generic-service   #通过name来指定服务类名，这里的generice-service是一个类名  
  
•         active_checks_enabled               1             #设定启用活动监测服务
  
•         passive_checks_enabled              1             #设定启用被动监测服务
  
•         parallelize_check                   1             #设定启用并发活动监测服务
  
•         obsess_over_service                 1             #设定启用服务防停滞
  
•         check_freshness                     0             #设定关闭更新监测
  
•         notifications_enabled               1             #设定启用事件通知   
  
•         event_handler_enabled               1             #设定启用事件处理程序
  
•         flap_detection_enabled              1             #设定启用状态抖动监测
  
•         failure_prediction_enabled          1             #设定启用故障预测
  
•         process_perf_data                   1             #设定启用进程性能数据记录
  
•         retain_status_information           1             #设定启用状态信息保存功能。当Nagios重新启动的时候不会是空数据，而是先显示上次离线时最后保留的状态数据。
  
•         retain_nonstatus_information        1             #设定启用非状态信息保存功能。当Nagios重新启动的时候不会是空数据，而是先显示上次离线时最后保留的非状态数据
  
•         is_volatile                         0             #设定服务非易失
  
•         check_period                      24x7            #设定监控的时间段
  
•         max_check_attempts                  3             #设定监测失败后最多尝试次数
  
•         normal_check_interval              10             #设定正常监测服务的间隔，单位分
  
•         retry_check_interval                2             #设定监测失败后尝试的间隔，单位分
  
•         contact_groups                  admins            #定义通知联系人租
  
•         notification_options            w,u,c,r ,d        #设定监测指定服务产生的事件通知的条件选项。这里后面跟上一些级别类型参数：
  
•                                                                w代表warning告警；
  
•                                                                u代表unknown未知；
  
•                                                                c代表critical严重；
  
•                                                                r代表recover恢复；
  
•                                                                d代表down奔溃。
  
•         notification_interval              60               #设定服务通知的间隔
  
•         notification_period               24x7              #设定服务通知运行时间
  
•          register                           0               #设定register表明本段定义的是一个服务类，而不是具体的服务   
  
•         }
  

        

4.etc/objects/localhost.cfg（本机监控文件）

• define host{                         #此定义的为监控主机的配置文件
  
•         use              linux-server       #引用类，在templates.cfg中预定义
  
•         host_name        localhost          #指定主机名，并不是实际机器的主机名，自己定义，方便以后在定义服务时调用
  
•         alias            localhost          #别名
  
•         address          127.0.0.1          #指定监控主机的地址
  
•         }
  
• define service{                       #此定义为监控主机服务的配置文件
  
•         use              local-service       #引用类，在templates.cfg中预定义
  
•         host_name        localhost           #指定主机名，在host段中预定义
  
•         service_description  PING            #监控服务的名称，也就是在web页面上显示的监控项目
  
•         check_command    check_ping!100.0,20%!500.0,60%    #具体监控的命令以及阀值
  
•         }  
  

备注： 以上定义的主机和服务，没有指定通知联系人，那是因为在其中引用了类，而templates.cfg中定义的类是有指定联系人的。

      

5.etc/objects/contacts.cfg（联系人配置文件）

• define contact{
  
•         contact_name        nagiosadmin     #定义联系人的名称，方便以后在监控项目中调用   
  
•         use                 generic-contact #引用类，在templates.cfg中预定义
  
•         alias               Nagios Admin    #别名   
  
•         email               test@abc.com    #邮件地址
  
•         }
  
• define contactgroup{
  
•         contactgroup_name    admins         #定义联系人组的名称，方便一次性发送多人
  
•         alias                Nagios Administrators   #别名
  
•         members              nagiosadmin    #定义组成员，这里nagiosadmin，也就是上面contact_name的值
  
•         }
  

        

6.etc/objects/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       #一周24小时
  
•         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
  
•         }
  
• 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
  
•         }
  

四、总结：

看过了以上配置文件的详解，来总结下监控一台主机和主机上的服务，必要的条件。

1.首先定义其监控主机，其中注意的就是引用的类必须在templates.cfg中预定义（所有未指定的条目，都按照类的定义载入）

2.再就是监控主机中的资源以及服务，指定的name必须在主机配置文件中预定义，还有就是指定的命令必须在command.cfg中预定义

3.还有就是类中定义的联系人或者联系人组必须在contacts.cfg中预定义

4.再有的细节问题，就自己慢慢摸索了、

备注：以上所说的预定义，其实写在任意位置都是可以的，只是为了有条理，日后也方便查找问题。



五、示例：

新建一台监控远程192.168.1.1主机，以及cpu、内存、硬盘使用率、进程数以及僵尸进程的配置文件。

解：vim etc/objects/192..168.1.1.cfg

define host{

        use linux-server

        host_name test

        alias test_1

        address 192.168.1.1

}

define service{

        use generic-service

        host_name test

        service_description CPU Load

        check_command check_nrpe!check_load

}

define service{

        use generic-service

        host_name test

        service_description Current Users

        check_command check_nrpe!check_users

}

define service{

        use generic-service

        host_name test

        service_description Disk Free Space /

        check_command check_nrpe!check_root

}

define service{

        use generic-service

        host_name test

        service_description Total Processes

        check_command check_nrpe!check_total_procs

}

define service{

        use generic-service,services-pnp

        host_name Mailbak

        service_description Zombie Processes

        check_command check_nrpe!check_zombie_procs

}

具体检测的命令都在libexec/下，每条检测命令后面加--help来查看其用法。



定义好后，检查下配置文件，然后重载nagios服务，就可以在web页面上查看了。



记录到此，旨在详解！也为日后方便查看！

后续：外部扩展


Nagios全系列笔记：

Nagios学习笔记之（一）最初搭建

Nagios学习笔记之（二）监控部署

Nagios学习笔记之（三）配置详解

Nagios学习笔记之（四）外部扩展
Nagios学习笔记之（五）后期维护