一、nagios默认配置文件介绍

nagios安装完毕后，默认的配置文件在/usr/local/nagios/etc目录下，每个文件或目录含义如下表所示：

二、配置文件之间的关系

       在nagios的配置过程中涉及到的几个定义有：主机、主机组，服务、服务组，联系人、联系人组，监控时间，监控命令等，从这些定义可以看出，nagios各个配置文件之间是互为关联，彼此引用的。

       成功配置出一台nagios监控系统，必须要弄清楚每个配置文件之间依赖与被依赖的关系，最重要的有四点：

第一：定义监控哪些主机、主机组、服务和服务组

第二：定义这个监控要用什么命令实现，

第三：定义监控的时间段，

第四：定义主机或服务出现问题时要通知的联系人和联系人组。

三、开始配置nagios

     为了能更清楚的说明问题，同时也为了维护方便，建议将nagios各个定义对象创建独立的配置文件，即为：

• 创建hosts.cfg文件来定义主机和主机组
• 创建services.cfg文件来定义服务
• 用默认的contacts.cfg文件来定义联系人和联系人组
• 用默认的commands.cfg文件来定义命令
• 用默认的timeperiods.cfg来定义监控时间段
• 用默认的templates.cfg文件作为资源引用文件

1、templates.cfg文件

       nagios主要用于监控主机资源以及服务，在nagios配置中称为对象，为了不必重复定义一些监控对象，Nagios引入了一个模板配置文件，将一些共性的属性定义成模板，以便于多次引用。这就是templates.cfg的作用。

      下面详细介绍下templates.cfg文件中每个参数的含义：

define contact{
        name                            generic-contact        #联系人名称，
        service_notification_period     24x7                   #当服务出现异常时，发送通知的时间段，这个时间段“7x24"在timeperiods.cfg文件中定义
        host_notification_period        24x7                   #当主机出现异常时，发送通知的时间段，这个时间段“7x24"在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
        }
 
define host{ 
        name                            generic-host    #主机名称，这里的主机名，并不是直接对应到真正机器的主机名，乃是对应到在主机配置文件里所设定的主机名。
        notifications_enabled           1            
        event_handler_enabled           1             
        flap_detection_enabled          1             
        failure_prediction_enabled      1           
        process_perf_data               1            
        retain_status_information       1           
        retain_nonstatus_information    1              
        notification_period             24x7           #指定“发送通知”的时间段，也就是可以在什么时候发送通知给使用者。
        register                        0              
        }
define host{
	name			generic-switch	; The name of this host template
	use			generic-host	; Inherit default values from the generic-host template----注意这里引用了上面定义的模板
	check_period		24x7		; By default, switches are monitored round the clock
	check_interval		5		; Switches are checked every 5 minutes
	retry_interval		1		; Schedule host check retries at 1 minute intervals
	max_check_attempts	10		; Check each switch 10 times (max)
	check_command		check-host-alive	; Default command to check if routers are "alive"
	notification_period	24x7		; Send notifications at any time
	notification_interval	30		; Resend notifications every 30 minutes
	notification_options	d,r		; Only send notifications for specific host states
	contact_groups		admins		; Notifications get sent to the admins by default
	register		0		; DONT REGISTER THIS - ITS JUST A TEMPLATE
	}

define service{
        name                            generic-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                   
        retain_nonstatus_information    1                      
        is_volatile                     0 
        check_period                    24x7      #这里的check_period告诉nagios检查服务的时间段。            
        max_check_attempts              3         #nagios对服务的最大检查次数。         
        normal_check_interval           10       #此选项是用来设置服务检查时间间隔，也就是说，nagios这一次检查和下一次检查之间所隔的时间，这里是10分钟。 
        retry_check_interval            2        #重试检查时间间隔，单位是分钟。          
        contact_groups                  admins   #指定联系人组，同上。            
        notification_options            w,u,c,r  #这个定义的是“通知可以被发出的情况”。w即warn，表示警告状态，u即unknown，表示不明状态，c即criticle，表示紧急状态，r即recover，表示恢复状态。也就是在服务出现警告状态、未知状态、紧急状态和重新恢复后都发送通知给使用者。
        notification_interval           60       #在服务出现异常后，故障一直没有解决，nagios再次对使用者发出通知的时间。单位是分钟。如果你认为，所有的事件只需要一次通知就够了，可以把这里的选项设为0。
        notification_period             24x7     #指定“发送通知”的时间段，也就是可以在什么时候发送通知给使用者。             
         register                        0                     
        }

2、resource.cfg文件

        resource.cfg是nagios的变量定义文件，文件内容只有一行：

# Sets $USER1$ to be the path to the plugins
$USER1$=/usr/local/nagios/libexec

       其中，变量$USER1$指定了安装nagios插件的路径，如果把插件安装在了其它路径，只需在这里进行修改即可。需要注意的是，变量必须先定义，然后才能在其它配置文件中进行引用。

3、理解Nagios宏及其工作机制

        Nagios配置非常灵活，继承和引用是一大特征，另一个重要特征就是可以在命令行的定义里使用宏，通过定义宏，nagios可以灵活的获取主机、服务和其它对象的信息。

（1）宏的工作机制

       在执行命令之前，nagios将对命令里的每个宏替换成它们应当取得的值。这种宏替换发生在Nagios执行各种类型的宏时候。例如主机和服务的检测、通知、事件处理等。

（2）宏的分类：默认宏、按需而成的宏、用户自定制宏等。

（3）默认宏：

1）主机IP地址宏

      当在命令定义中使用主机或服务宏时，宏将要执行所用的值指向主机或服务所带有值。看下面这个例子，假定在check_ping命令定义里使用了一个主机对象，例如这样：

define host{
host_name	 ixdba
address	 192.168.12.246
check_command	 check_ping
...
}
define command{
command_name check_ping
command_line /usr/local/nagios/libexec/check_ping -H $HOSTADDRESS$ -w 100.0,90% -c 200.0,60%
}

       那么执行这个主机检测命令时展开并最终执行的将是这样的：

/usr/local/nagios/libexec/check_ping -H 192.168.12.246 -w 100.0,90% -c 200.0,60%

2）命令参数宏

        同样你可以向命令传递参数，这样可以保证命令定义更具通用性。参数指定在对象（象主机或服务）中定义，用一个“!”来分隔，例如这样：

define service{
host_name	 linuxbox
service_description	PING
check_command	 check_ping!200.0,80%!400.0,40%
...
}

        在上例中，服务的检测命令中含有两个参数(请参考$ARGn$宏)，而$ARG1$宏将是"200.0,80%"，同时$ARG2$将是"400.0,40%"(都不带引号)。假定使用之前的主机定义并这样来定义你的check_ping命令：

define command{
command_name check_ping
command_line /usr/local/nagios/libexec/check_ping -H $HOSTADDRESS$ -w $ARG1$ -c $ARG2$
}

      那么对于服务的检测命令最终将是这样子的：

/usr/local/nagios/libexec/check_ping -H 192.168.12.246 -w 200.0,80% -c 400.0,40%

（4）Nagios可用的全部的宏

1）主机宏

• $HOSTNAME$ 主机简称(如"web")，取自于主机定义里的host_name域
• $HOSTADDRESS$
  主机地址。取自于主机定义里的address域

2）服务宏

• $SERVICESTATE$ 服务状态描述，有w，u，c
• $SERVICEDESC$ 对当前服务的描述 

3）联系人宏

• $CONTACTNAME$ 表示联系人，在联系人文件中定义

4）通知宏

• $NOTIFICATIONTYPE$ 返回下面信息：("PROBLEM", "RECOVERY", "ACKNOWLEDGEMENT", "FLAPPINGSTART",
  "FLAPPINGSTOP", "FLAPPINGDISABLED", "DOWNTIMESTART", "DOWNTIMEEND", or "DOWNTIMECANCELLED").

5）日期/时间宏

• $LONGDATETIME$ 当前的日期/时间戳

6）文件宏

• $LOGFILE$ 日志文件的保存位置。
• $MAINCONFIGFILE$ 主配置文件的保存位置。

7）其他宏

• $ADMINEMAIL$
  全局的管理员EMail地址
• $ARGn$ 指向第n个命令传递参数(通知、事件处理、服务检测等)。Nagios支持最多32个参数宏

4、commands.cfg文件

       此文件默认是存在的，无需修改即可使用，当然如果有新的命令需要加入时，在此文件进行添加即可。这里并未列出文件的所有内容，仅仅介绍了配置中用到的一些命令。

#下面是notify-host-by-email命令的定义
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: $HOSTOUTPUT$\n\nDate/Time: $LONGDATETIME$\n" | /bin/mail -s "** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **" $CONTACTEMAIL$    #命令具体的执行方式，“-H $HOSTADDRESS$” 是定义目标主机的地址，这个地址在hosts.cfg文件中定义了。
        }

#下面是notify-host-by-email命令的定义
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$\nState: $SERVICESTATE$\n\nDate/Time: $LONGDATETIME$\n\nAdditional Info:\n\n$SERVICEOUTPUT$" | /bin/mail -s "** $NOTIFICATIONTYPE$ Service Alert: $HOSTALIAS$/$SERVICEDESC$ is $SERVICESTATE$ **" $CONTACTEMAIL$
        }

#下面是notify-host-by-email命令的定义
	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$=/usr/local/nagios/libexec，那么check_ping的完整路径为/usr/local/nagios/libexec/check_ping。 “-w 3000.0,80%”中“-w”说明后面的一对值对应的是“WARNING”状态，“80%”是其临界值。“-c 5000.0,100%”中“-c”说明后面的一对值对应的是“CRITICAL”，“100%”是其临界值。“-p 1”说明每次探测发送一个包。
        }

#下面是notify-host-by-email命令的定义
	define command{
        command_name    check_ftp
        command_line    $USER1$/check_ftp -H $HOSTADDRESS$ $ARG1$   	#$ARG1$是指在调用这个命令的时候，命令后面的第一个参数。
        }

#下面是check_http命令的定义
	define command{
        command_name    check_http
        command_line    $USER1$/check_http -I $HOSTADDRESS$ $ARG1$
        }

#下面是check_ssh命令的定义
	define command{
        command_name    check_ssh
        command_line    $USER1$/check_ssh $ARG1$ $HOSTADDRESS$
        }
......

5、 hosts.cfg文件

        此文件默认不存在，需要手动创建，hosts.cfg主要用来指定被监控的主机地址以及相关属性信息，一个配置好的实例如下：

define host{
        use                     linux-server		#引用主机linux-server的属性信息，linux-server主机在templates.cfg文件中进行了定义。
        host_name               web				#主机名
        alias                    test-web		#主机别名
        address                 192.168.12.251		#被监控的主机地址，这个地址可以是ip，也可以是域名。
        }

define host{
        use                     linux-server
        host_name              mysql
        alias                    ixdba-mysql
        address                 192.168.12.237
        }

define hostgroup{						#定义一个主机组
       hostgroup_name  sa-servers      		#主机组名称，可以随意指定。
       alias           sa servers				#主机组别名
       members         web,mysql			#主机组成员，其中“web”、“mysql”就是上面定义的两个主机。
       }

6、services.cfg文件

         此文件默认也不存在，需要手动创建，services.cfg文件主要用于定义监控的服务和主机资源，例如监控http服务、ftp服务、主机磁盘空间、主机系统负载等等。

#################  ixdba   web  #####################
define service{
        use                      local-service  #引用local-service服务的属性值，local-service在templates.cfg文件中进行了定义。
        host_name                  web		#指定要监控哪个主机上的服务，“web”在hosts.cfg文件中进行了定义。
        service_description      PING		#对监控服务内容的描述，以供维护人员参考。
        check_command          check_ping!100.0,20%!500.0,60%	#指定检查的命令，check_ping命令在commands.cfg中定义，后跟两个参数，命令与参数间用!分割。       
        }

define service{
        use                             local-service
        host_name                  web
        service_description      SSH
        check_command         check_ssh  		# check_ssh命令也在commands.cfg中定义。
        }

define service{
        use                               local-service
        host_name                    web
        service_description        SSHD
        check_command           check_tcp!22
        }

7、 contacts.cfg文件

       contacts.cfg是一个定义联系人和联系人组的配置文件，当监控的主机或者服务出现故障，nagios会通过指定的通知方式（邮件或者短信）将信息发给这里指定的联系人或者使用者。

define contact{
        contact_name                    sasystem		#联系人名称
        use                             generic-contact	#引用generic-contact的属性信息，其中“generic-contact”在templates.cfg文件中进行定义
        alias                           sa-system		#联系人别名
        email                          ixdba@126.com  #联系人的邮件地址
        }

define contactgroup {
      contactgroup_name    admins	#联系人组名称
      alias                system administrator group	#联系人组描述
      members              sasystem		#联系人组成员，其中“sasystem”就是上面定义的联系人
}

8、 timeperiods.cfg文件

        此文件只要用于定义监控的时间段，下面是一个配置好的实例：

#下面是定义一个名为24x7的时间段，即监控所有时间段
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
        }

9、 cgi.cfg文件

        此文件用来控制相关cgi脚本，如果想在nagios的web监控界面执行cgi脚本，例如重启nagios进程、关闭nagios通知、停止nagios主机检测等，这时就需要配置cgi.cfg文件了。

        由于nagios的web监控界面验证用户为test，所以只需在cgi.cfg文件中添加此用户的执行权限就可以了，需要修改的配置信息如下：

default_user_name=test
authorized_for_system_information=nagiosadmin,test
authorized_for_configuration_information=nagiosadmin,test
authorized_for_system_commands=test
authorized_for_all_services=nagiosadmin,test
authorized_for_all_hosts=nagiosadmin,test
authorized_for_all_service_commands=nagiosadmin,test
authorized_for_all_host_commands=nagiosadmin,test

10、 nagios.cfg文件

       nagios.cfg默认的路径为/usr/local/nagios/etc/nagios.cfg，是nagios的核心配置文件，所有的对象配置文件都必须在这个文件中进行定义才能发挥其作用，这里只需将对象配置文件在Nagios.cfg文件中进行引用即可。

log_file=/usr/local/nagios/var/nagios.log
“log_file”变量用来定义nagios日志文件的路径。
cfg_file=/usr/local/nagios/etc/hosts.cfg
cfg_file=/usr/local/nagios/etc/services.cfg
cfg_file=/usr/local/nagios/etc/commands.cfg
cfg_file=/usr/local/nagios/etc/contacts.cfg
cfg_file=/usr/local/nagios/etc/timeperiods.cfg
cfg_file=/usr/local/nagios/etc/templates.cfg
“cfg_file”变量用来引用对象配置文件，如果有更多的对象配置文件，在这里依次添加即可。
object_cache_file=/usr/local/nagios/var/objects.cache
该变量用于指定一个“所有对象配置文件”的副本文件，或者叫对象缓冲文件