本篇主要介绍下安装完Nagios服务端后的配置目录及文件参数的解释,可供大家备忘!
首先解释下安装Nagios的时候make的含义如下:
make all //安装所有主程序
make install //来安装主程序,CGI和HTML文件
make install-init //在/etc/rc.d/init.d安装启动脚本
make install-config //来安装示例配置文件,安装的路径是/usr/local/nagios/etc
make install-commandmode //来配置目录权限
make install-webconf // 配置nagios跟apache整合
默认安装完Nagios,配置文件主目录在/usr/local/nagios/下,目录各种的功能如下:
bin |
Nagios 可执行程序所在目录 |
etc |
Nagios 配置文件所在目录 |
sbin |
Nagios CGI 文件所在目录,也就是执行外部命令所需文件所在的目录 |
share |
Nagios网页文件所在的目录 |
libexec |
Nagios 外部插件所在目录 |
var |
Nagios 日志文件、lock 等文件所在的目录 |
var/archives |
Nagios 日志自动归档目录 |
var/rw |
用来存放外部命令文件的目录 |
/usr/local/nagios/etc这个文件夹都是Nagios的配置文件,详细如下
cgi.cfg文件
此文件用来控制相关cgi脚本,如果想在nagios的web监控界面执行cgi脚本,例如重启nagios进程、关闭nagios通知、停止nagios主机检测等,这时就需要配置cgi.cfg文件了。
由于nagios的web监控界面验证用户为david,所以只需在cgi.cfg文件中添加此用户的执行权限就可以了,需要修改的配置信息如下:
1
2
3
4
5
6
7
8
|
default_user_name=david
authorized_for_system_information=nagiosadmin,david
authorized_for_configuration_information=nagiosadmin,david
authorized_for_system_commands=david
authorized_for_all_services=nagiosadmin,david
authorized_for_all_hosts=nagiosadmin,david
authorized_for_all_service_commands=nagiosadmin,david
authorized_for_all_host_commands=nagiosadmin,david
|
nagios.cfg内容详解:
nagios.cfg默认的路径为/usr/local/nagios/etc/nagios.cfg,是nagios的核心配置文件,所有的对象配置文件都必须在这个文件中进行定义才能发挥其作用,这里只需将对象配置文件在Nagios.cfg文件中进行引用即可。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
|
log_file=
/usr/local/nagios/var/nagios
.log
# 定义nagios日志文件的路径
cfg_file=
/usr/local/nagios/etc/objects/commands
.cfg
# “cfg_file”变量用来引用对象配置文件,如果有更多的对象配置文件,在这里依次添加即可。
cfg_file=
/usr/local/nagios/etc/objects/contacts
.cfg
cfg_file=
/usr/local/nagios/etc/objects/hosts
.cfg
cfg_file=
/usr/local/nagios/etc/objects/services
.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
# 本机配置文件
cfg_file=
/usr/local/nagios/etc/objects/windows
.cfg
# windows 主机配置文件
object_cache_file=
/usr/local/nagios/var/objects
.cache
# 该变量用于指定一个“所有对象配置文件”的副本文件,或者叫对象缓冲文件
precached_object_file=
/usr/local/nagios/var/objects
.precache
resource_file=
/usr/local/nagios/etc/resource
.cfg
# 该变量用于指定nagios资源文件的路径,可以在nagios.cfg中定义多个资源文件。
status_file=
/usr/local/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配置中所有的时间单位都是分钟。
|
resource.cfg文件
resource.cfg是nagios的变量定义文件,文件内容只有一行:
$USER1$=/usr/local/nagios/libexec
其中,变量$USER1$指定了安装nagios插件的路径,如果把插件安装在了其它路径,只需在这里进行修改即可。需要注意的是,变量必须先定义,然后才能在其它配置文件中进行引用。
commands.cfg文件
此文件默认是存在的,无需修改即可使用,当然如果有新的命令需要加入时,在此文件进行添加即可。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
#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\nAdditionalInfo:\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;
# “-w3000.0,80%”中“-w”说明后面的一对值对应的是“WARNING”状态,“80%”是其临界值。
# “-c5000.0,100%”中“-c”说明后面的一对值对应的是“CRITICAL”,“100%”是其临界值。
# “-p 1”说明每次探测发送一个包。
}
|
hosts.cfg文件
此文件默认不存在,需要手动创建,hosts.cfg主要用来指定被监控的主机地址以及相关属性信息,根据实验目标配置如下:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
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
bsmartservers
#主机组别名
members Nagios-Linux
#主机组成员,其中“Nagios-Linux”就是上面定义的主机。
}
|
services.cfg文件
此文件默认也不存在,需要手动创建,services.cfg文件主要用于定义监控的服务和主机资源,例如监控http服务、ftp服务、主机磁盘空间、主机系统负载等等。Nagios-Server 和Nagios-Windows 相关服务已在相应的配置文件中定义,所以这里只需要定义Nagios-Linux 相关服务即可,这里只定义一个检测是否存活的服务来验证配置文件的正确性.
1
2
3
4
5
6
|
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会通过指定的通知方式(邮件或者短信)将信息发给这里指定的联系人或者使用者。
1
2
3
4
5
6
7
8
9
10
11
12
|
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
TechnicalSupport
#联系人组描述
members David
#联系人组成员,其中“david”就是上面定义的联系人,如果有多个联系人则以逗号相隔
}
|
timeperiods.cfg文件详解:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
|
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 ; DONTREGISTER THIS DEFINITION - ITS NOT A REAL CONTACT, JUST A TEMPLATE!
}
define host{
name generic-host ; 主机名称,这里的主机名,并不是直接对应到真正机器的主机名;
; 乃是对应到在主机配置文件里所设定的主机名。
notifications_enabled 1 ; Hostnotifications are enabled
event_handler_enabled 1 ; Host eventhandler is enabled
flap_detection_enabled 1 ; Flap detectionis enabled
failure_prediction_enabled 1 ; Failure prediction is enabled
process_perf_data 1 ; 其值可以为0或1,其作用为是否启用Nagios的数据输出功能;
; 如果将此项赋值为1,那么Nagios就会将收集的数据写入某个文件中,以备提取。
retain_status_information 1 ; Retain status informationacross program restarts
retain_nonstatus_information 1 ; Retainnon-status information across program restarts
notification_period 24x7 ; 指定“发送通知”的时间段,也就是可以在什么时候发送通知给使用者。
register 0 ; DONT REGISTERTHIS 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 REGISTERTHIS DEFINITION - ITS NOT A REAL HOST, JUST A TEMPLATE!
}
define host{
name windows-server ; The name of thishost template
use generic-host ; Inherit defaultvalues from the generic-host template
check_period 24x7 ; By default, Windows servers aremonitored round the clock
check_interval 5 ; Actively check the server every5 minutes
retry_interval 1 ; Schedule host check retries at1 minute intervals
max_check_attempts 10 ; Check each server 10
times
(max)
check_command check-host-alive ; Defaultcommand to check
if
servers are
"alive"
notification_period 24x7 ; Send notification out at any
time
- day or night
notification_interval 10 ; Resend notifications every 30minutes
notification_options d,r ; Only send notifications forspecific host states
contact_groups ts ; Notifications get sent to theadmins by default
hostgroups windows-servers; Host
groups
that Windows servers should be a member of
register 0 ; DONT REGISTER THIS - ITS JUSTA TEMPLATE
}
define service{
name generic-service ; 定义一个服务名称
active_checks_enabled 1 ; Activeservice checks are enabled
passive_checks_enabled 1 ; Passiveservice checks are enabled
/accepted
parallelize_check 1 ; Active service checksshould be parallelized;
; (disabling this can lead to major performance problems)
obsess_over_service 1 ; We should obsess over this service (ifnecessary)
check_freshness 0 ; Defaultis to NOT check service
'freshness'
notifications_enabled 1 ; Servicenotifications are enabled
event_handler_enabled 1 ; Serviceevent handler is enabled
flap_detection_enabled 1 ; Flapdetection is enabled
failure_prediction_enabled 1 ; Failure prediction is enabled
process_perf_data 1 ; Processperformance data
retain_status_information 1 ; Retainstatus information across program restarts
retain_nonstatus_information 1 ; Retain non-statusinformation across program restarts
is_volatile 0 ; Theservice 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 aboutservice problems every hour
notification_period 24x7 ; 指定“发送通知”的时间段,也就是可以在什么时候发送通知给使用者。
register 0 ; DONT REGISTER THIS DEFINITION- ITS NOT A REAL SERVICE, JUST A TEMPLATE!
}
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
#下面是定义一个名为24x7的时间段,即监控所有时间段
define timeperiod{
timeperiod_name 24x7
#时间段的名称,这个地方不要有空格
alias
24 Hours A Day, 7Days 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 WorkHours
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
}
|
验证Nagios配置文件的正确性
Nagios 在验证配置文件方面做的非常到位,只需通过一个命令即可完成:
1
|
# /usr/local/nagios/bin/nagios -v/usr/local/nagios/etc/nagios.cfg
|
本文转自Jacken_yang 51CTO博客,原文链接:http://blog.51cto.com/linuxnote/1637773,如需转载请自行联系原作者