Nagios配置文件介绍
来源:互联网 发布:arp s绑定mac 编辑:程序博客网 时间:2024/05/16 11:30
Nagios 安装完毕后,默认的配置文件在/usr/local/nagios/etc目录下
每个文件或目录含义如下表所示:
文件名或目录名用途cgi.cfg控制CGI访问的配置文件nagios.cfgNagios 主配置文件resource.cfg变量定义文件,又称为资源文件,在些文件中定义变量,以便由其他配置文件引用,如$USER1$objectsobjects 是一个目录,在此目录下有很多配置文件模板,用于定义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 主机的一个配置文件模板,默认没有启用此文件1.配置文件之间的关系
在nagios的配置过程中涉及到的几个定义有:主机、主机组,服务、服务组,联系人、联系人组,监控时间,监控命令等,从这些定义可以看出,nagios各个配置文件之间是互为关联,彼此引用的。
成功配置出一台nagios监控系统,必须要弄清楚每个配置文件之间依赖与被依赖的关系,最重要的有四点:
第一:定义监控哪些主机、主机组、服务和服务组;
第二:定义这个监控要用什么命令实现;
第三:定义监控的时间段;
第四:定义主机或服务出现问题时要通知的联系人和联系人组。
2.配置Nagios
为了能更清楚的说明问题,同时也为了维护方便,建议将nagios各个定义对象创建独立的配置文件:
- 创建hosts.cfg文件来定义主机和主机组
- 创建services.cfg文件来定义服务
- 用默认的contacts.cfg文件来定义联系人和联系人组
- 用默认的commands.cfg文件来定义命令
- 用默认的timeperiods.cfg来定义监控时间段
- 用默认的templates.cfg文件作为资源引用文件
3.nagios.cfg
在一般情况下,首次安装Nagios时,用户很少需要更改nagios.cfg文件中的内容。用户可能需要修改nagios.cfg中的两条指令,其中一条用于指定对象配置文件的位置,另一条则是check_external_commands指令,两种指定对象配置文件的位置的方法:1.cfg_file 2.cfg_dir,分别指定对象配置文件的位置和目录,如下:
cfg_file=/usr/local/nagios/etc/contactgroups.cfg
cfg_dir=/usr/local/nagios/etc
接下来,如果希望Web界面中的CGI命令能够正常工作,或者想使用外部命令,应当将Nagios设置为接收来自于命令文件的外部命令,设置如下:
check_external_commands=1
Nagios中的指令分为两类:全局功能开关(global enabler)和全局超时设置(global timeout)
全局功能开关:
execute_service_checks默认值为1(启用)。设置为0时将在程序范围内禁用服务检测accept_passive_service_checks默认值为1(启用)。设置启用或禁用主机检测execute_host_checks默认值为1(启用)。设置启用或禁用主机检测accept_passive_host_checks默认值为1(启用)。设置为0时将在程序范围内禁用被动服务检测enable_notifications默认值为1(启用)。设置Nagios是否发送通知enable_event_handlers默认值为1(启用)。设置全局启用或禁用时间句柄process_performance_data默认值为0(禁用)。设置Nagios是否检测并处理插件提供的性能数据
全局超时设置:
4.cgi.cfg
cgi.cfg中大部分指令都是用于设置组成Web界面CGI程序的,CGI程序将根据这些信息发送命令,并从Nagios守护进程中获取所需信息。
default_user_name=davidauthorized_for_system_information=nagiosadmin,david authorized_for_configuration_information=nagiosadmin,david authorized_for_system_commands=davidauthorized_for_all_services=nagiosadmin,david authorized_for_all_hosts=nagiosadmin,davidauthorized_for_all_service_commands=nagiosadmin,david authorized_for_all_host_commands=nagiosadmin,david
5.templates.cfg
nagios主要用于监控主机资源以及服务,在nagios配置中称为对象,为了不必重复定义一些监控对象,Nagios引入了一个模板配置文件,将一些共性的属性定义成模板,以便于多次引用。这就是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! }6.resource.cfg
resource.cfg是nagios的变量定义文件,文件内容只有一行:
$USER1$=/usr/local/nagios/libexec7.commands.cfg
命令是Nagios的功能核心。命令是Nagios调用外部程序的方式。
命令对象最常用的用途是调用插件,命令对象仅有两条指令,command_name,用于指定对象名称,以便其他对象引用;command_line定义了命令的Shell语法。
此文件默认是存在的,无需修改即可使用,当然如果有新的命令需要加入时,在此文件进行添加即可
#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$ }
8.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”就是上面定义的主机。 }
9.localhost.cfg,windows.cfg
分别定义监控主机本身和windows主机,默认有配置
10.service.cfg
此文件默认也不存在,需要手动创建,services.cfg文件主要用于定义监控的服务和主机资源,例如监控http服务、ftp服务、主机磁盘空间、主机系统负载等等
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 #指定检查的命令。 }11.contacts.cfg
contacts.cfg是一个定义联系人和联系人组的配置文件,当监控的主机或者服务出现故障,nagios会通过指定的通知方式(邮件或者短信)将信息发给这里指定的联系人或者使用者
define contact{ contact_name David #联系人的名称,这个地方不要有空格 use generic-contact #引用generic-contact的属性信息,其中“generic-contact”在templates.cfg文件中进行定义 alias Nagios Admin email david.tang@bsmart.cn }define contactgroup{ contactgroup_name ts #联系人组的名称,同样不能空格 alias Technical Support #联系人组描述 members David #联系人组成员,其中“david”就是上面定义的联系人,如果有多个联系人则以逗号相隔 }12.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 }
验证配置的正确性,只需要一条指令:
# /usr/local/nagios/bin/nagios -v /usr/local/nagios/etc/nagios.cfg
看到上面这些信息就说明没问题了,然后启动Nagios 服务。
- nagios配置文件介绍
- Nagios配置文件介绍
- nagios介绍
- Nagios 配置文件详解
- nagios配置文件说明
- nagios配置文件详解
- Nagios配置文件详解
- nagios 配置文件详解
- Nagios配置文件详解
- Nagios配置文件详解
- nagios基本配置介绍
- Nagios - NDOUTILS介绍
- Nagios - NRPE 介绍
- nagios 插件介绍
- Nagios的插件介绍
- Nagios检测工具介绍
- Nagios之配置介绍
- Ganglia与Nagios介绍
- eclipse中将项目打包成jar的两种方法,及其问题与解决方法
- MySQL简单主从配置
- Webpack3的使用(四)
- C++ primer学习12.20
- 前端菜鸟用Vue+express+mysql自己撸了个简单博客
- Nagios配置文件介绍
- OKHTTP封装公共参数
- 大型程序的结构
- 蓝桥杯-算法提高-任意年月日历输出
- 宋利:编码既是技术也是艺术
- MySQL 普通索引、唯一索引和主索引
- StarWars.Android碎片式过渡动画
- Capstone训练营11
- IT与风投