六。配置Nagios文件（一）

814247614

　　Nagios 主要用于监控一台或者多台本地主机及远程的各种信息，包括本机资源及对外的服务等。默认的Nagios 配置没有任何监控内容，仅是一些模板文件。若要让Nagios 提供服务，就必须修改配置文件，增加要监控的主机和服务，下面将详细介绍。
　　6.1 默认配置文件介绍
　　Nagios 安装完毕后，默认的配置文件在/usr/local/nagios/etc目录下。

　　每个文件或目录含义如下表所示：
　　文件名或目录名
　　用途
　　cgi.cfg
　　控制CGI访问的配置文件
　　nagios.cfg
　　Nagios 主配置文件
　　resource.cfg
　　变量定义文件，又称为资源文件，在些文件中定义变量，以便由其他配置文件引用，如$USER1$
　　objects
　　objects 是一个目录，在此目录下有很多配置文件模板，用于定义Nagios 对象
　　objects/commands.cfg
　　命令定义配置文件，其中定义的命令可以被其他配置文件引用
　　objects/contacts.cfg
　　定义联系人和联系人组的配置文件
　　objects/localhost.cfg
　　定义监控本地主机的配置文件
　　objects/printer.cfg
　　定义监控打印机的一个配置文件模板，默认没有启用此文件
　　objects/switch.cfg
　　定义监控路由器的一个配置文件模板，默认没有启用此文件
　　objects/templates.cfg
　　定义主机和服务的一个模板配置文件，可以在其他配置文件中引用
　　objects/timeperiods.cfg
　　定义Nagios 监控时间段的配置文件
　　objects/windows.cfg
　　监控Windows 主机的一个配置文件模板，默认没有启用此文件
　　6.2 配置文件之间的关系
　　在nagios的配置过程中涉及到的几个定义有：主机、主机组，服务、服务组，联系人、联系人组，监控时间，监控命令等，从这些定义可以看出，nagios各个配置文件之间是互为关联，彼此引用的。
　　成功配置出一台nagios监控系统，必须要弄清楚每个配置文件之间依赖与被依赖的关系，最重要的有四点：
　　第一：定义监控哪些主机、主机组、服务和服务组；
　　第二：定义这个监控要用什么命令实现；
　　第三：定义监控的时间段；
　　第四：定义主机或服务出现问题时要通知的联系人和联系人组。
　　6.3 配置Nagios
　　为了能更清楚的说明问题，同时也为了维护方便，建议将nagios各个定义对象创建独立的配置文件：
　　·  创建hosts.cfg文件来定义主机和主机组
　　·  创建services.cfg文件来定义服务
　　·  用默认的contacts.cfg文件来定义联系人和联系人组
　　·  用默认的commands.cfg文件来定义命令
　　·  用默认的timeperiods.cfg来定义监控时间段
　　·  用默认的templates.cfg文件作为资源引用文件
　　a. 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!
　　}
　　b. resource.cfg文件
　　resource.cfg是nagios的变量定义文件，文件内容只有一行：
　　$USER1$=/usr/local/nagios/libexec
　　其中，变量$USER1$指定了安装nagios插件的路径，如果把插件安装在了其它路径，只需在这里进行修改即可。需要注意的是，变量必须先定义，然后才能在其它配置文件中进行引用。
　　c. 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$                                     #命令具体的执行方式。
　　}
　　#notify-service-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$\n" | /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$=/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”说明每次探测发送一个包。
　　}
　　define command{
　　command_name    check_local_disk
　　command_line    $USER1$/check_disk -w $ARG1$ -c $ARG2$ -p $ARG3$            #$ARG1$是指在调用这个命令的时候，命令后面的第一个参数。
　　}
　　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$
　　}
　　define command{
　　command_name    check_local_users
　　command_line    $USER1$/check_users -w $ARG1$ -c $ARG2$
　　}
　　define command{
　　command_name    check_local_swap
　　command_line    $USER1$/check_swap -w $ARG1$ -c $ARG2$
　　}
　　define command{
　　command_name    check_ftp
　　command_line    $USER1$/check_ftp -H $HOSTADDRESS$ $ARG1$
　　}
　　define command{
　　command_name    check_http
　　command_line    $USER1$/check_http -I $HOSTADDRESS$ $ARG1$
　　}
　　define command{
　　command_name    check_ssh
　　command_line    $USER1$/check_ssh $ARG1$ $HOSTADDRESS$
　　}
　　define command{
　　command_name    check_ping
　　command_line    $USER1$/check_ping -H $HOSTADDRESS$ -w $ARG1$ -c $ARG2$ -p 5
　　}
　　define command{
　　command_name    check_nt
　　command_line    $USER1$/check_nt -H $HOSTADDRESS$ -p 12489 -v $ARG1$ $ARG2$
　　}