不管是用nagios监控本地还是远程服务器，都需要对nagios进行配置。
nagios这种可插拔的配置非常简单易懂。
Nagios的配置文件结构如下:
在nagios的安装包sample-config/有配置的参考
/usr/local/Nagios/etc/
nagios.cfg
cgi.cfg
resource.cfg
object/
…
############################
nagios.cfg:
指定对象配置文件的位置：
cfg_file=/usr/local/nagios/etc/hosts.cfg
或
cfg_dir=/usr/local/nagios/etc
check_external_commands=1 #使用外部命令
############################
fabfile:定义fab命令的.
具体怎样写fab命令参考python的fab文档。
###########################
Templates表示模板，分两种：
Use顺序：
Ohtpl
Bhtpl
Htpl
-----------------
Hosts:
App:主要使用这个文件夹里的模板
创建hostgroups之后创建这个hosts模板在hosts中调用。
define host{
use <template-name1>,\
<template-name2> #use表示在这里嵌套调用其它的更底层的模板。
name bhtpl/htpl_<dir>_<file-name> #用templates/hosts/目录下的路径dir来命名。
hostgroups +<hostgroup-name1>,\ #以+开头表示添加
<hostgroup-name2> #这些文件定义在hostgroups中
alias <file-name-upper> - <alias-name> #将这个文件名大写，然后取个别名
_<name> <value> #这里可以定义某些变量的默认值
register 0 #表示没有注册
host的name是 前缀_路径_文件名 组成的
-------------------
Services：
App：主要用这个里面的模板。
defineservice{
use template-name1>,\
<template-name2> #嵌套调用更基础的模板
name <file-name> #和文件名一样,都是用cstpl/stpl开头加路径加名字
check_command <check_XXX>\
!–options $VAR$
!-options/- -options $VAR$ \
！
$ARGS$ #用！分割参数，同时用$表示一个参数
servicegroups +<servicegroups-name1>,\ #以+开头表示添加
<servicegroups-name2> #这些服务分组名在servicesgroup定义。
alias <file-name-upper> - <alias-name> #将这个文件名大写，然后取个别名
_<VAR> value #在这里定义变量的默认值
register 0 #注册为0
}
Service的name是文件名，也是前缀_路径_名字 组成
###########################
Incgroups:增加或删除对hosts的检查
App:主要用这个里面的
增加一个service就是增加一个incgroups，然后再hosts和services里面同时调用这个incgroups就可以了。
define hostgroup{
hostgroup_name inc_<dir>_<file-name> #inc为前缀
alias <name> - <alias>
register 0
}
define hostgroup{
hostgroup_name exc_<dir>_<file-name> #exc为前缀
alias <name> - <alias>
register 0
}
############################
Commands:
定义宏与外部程序的映射关系。
#说明命令用法
#
#说明参数有哪些
#
#说明返回值
|
definecommand{ |
||
|
command_name |
command_name |
|
|
command_line |
command_line |
|
|
} |
||
|
definehost{ |
||
|
host_name |
host_name |
|
|
alias |
alias |
|
|
display_name |
display_name |
|
|
address |
address |
|
|
parents |
host_names |
|
|
hourly_value |
# |
|
|
hostgroups |
hostgroup_names |
|
|
check_command |
command_name |
|
|
initial_state |
[o,d,u] |
|
|
max_check_attempts |
# |
|
|
check_interval |
# |
|
|
retry_interval |
# |
|
|
active_checks_enabled |
[0/1] |
|
|
passive_checks_enabled |
[0/1] |
|
|
check_period |
timeperiod_name |
|
|
obsess_over_host|obsess |
[0/1] |
|
|
check_freshness |
[0/1] |
|
|
freshness_threshold |
# |
|
|
event_handler |
command_name |
|
|
event_handler_enabled |
[0/1] |
|
|
low_flap_threshold |
# |
|
|
high_flap_threshold |
# |
|
|
flap_detection_enabled |
[0/1] |
|
|
flap_detection_options |
[o,d,u] |
|
|
process_perf_data |
[0/1] |
|
|
retain_status_information |
[0/1] |
|
|
retain_nonstatus_information |
[0/1] |
|
|
contacts |
contacts |
|
|
contact_groups |
contact_groups |
|
|
notification_interval |
#再次发出通知的时间间隔，分钟。0表示不重新发送。 |
|
|
first_notification_delay |
# |
|
|
notification_period |
timeperiod_name#再次发送通知的时间。 |
|
|
notification_options |
[d,u,r,f,s] |
|
|
notifications_enabled |
[0/1] |
|
|
stalking_options |
[o,d,u] |
|
|
notes |
note_string |
|
|
notes_url |
url |
|
|
action_url |
url |
|
|
icon_image |
image_file |
|
|
icon_image_alt |
alt_string |
|
|
vrml_image |
image_file |
|
|
statusmap_image |
image_file |
|
|
2d_coords |
x_coord,y_coord |
|
|
3d_coords |
x_coord,y_coord,z_coord |
|
|
} |
||
|
definehostgroup{ |
||
|
hostgroup_name |
hostgroup_name |
|
|
alias |
alias |
|
|
members |
hosts |
|
|
hostgroup_members |
hostgroups |
|
|
notes |
note_string |
|
|
notes_url |
url |
|
|
action_url |
url |
|
|
} |
||
|
defineservice{ |
||
|
host_name |
host_name |
|
|
hostgroup_name |
hostgroup_name |
|
|
service_description |
service_description |
|
|
display_name |
display_name |
|
|
parents |
service_descriptions |
|
|
hourly_value |
# |
|
|
servicegroups |
servicegroup_names |
|
|
is_volatile |
[0/1] |
|
|
check_command |
command_name |
|
|
initial_state |
[o,w,u,c] |
|
|
max_check_attempts |
# |
|
|
check_interval |
# |
|
|
retry_interval |
# |
|
|
active_checks_enabled |
[0/1] |
|
|
passive_checks_enabled |
[0/1] |
|
|
check_period |
timeperiod_name |
|
|
obsess_over_service|obsess |
[0/1] |
|
|
check_freshness |
[0/1] |
|
|
freshness_threshold |
# |
|
|
event_handler |
command_name |
|
|
event_handler_enabled |
[0/1] |
|
|
low_flap_threshold |
# |
|
|
high_flap_threshold |
# |
|
|
flap_detection_enabled |
[0/1] |
|
|
flap_detection_options |
[o,w,c,u] |
|
|
process_perf_data |
[0/1] |
|
|
retain_status_information |
[0/1] |
|
|
retain_nonstatus_information |
[0/1] |
|
|
notification_interval |
# |
|
|
first_notification_delay |
# |
|
|
notification_period |
timeperiod_name |
|
|
notification_options |
[w,u,c,r,f,s] |
|
|
notifications_enabled |
[0/1] |
|
|
contacts |
contacts |
|
|
contact_groups |
contact_groups |
|
|
stalking_options |
[o,w,u,c] |
|
|
notes |
note_string |
|
|
notes_url |
url |
|
|
action_url |
url |
|
|
icon_image |
image_file |
|
|
icon_image_alt |
alt_string |
|
|
} |
||
|
defineservicegroup{ |
||
|
servicegroup_name |
servicegroup_name |
|
|
alias |
alias |
|
|
members |
services |
|
|
servicegroup_members |
servicegroups |
|
|
notes |
note_string |
|
|
notes_url |
url |
|
|
action_url |
url |
|
|
} |
||
|
definecontact{ |
||
|
contact_name |
contact_name |
|
|
alias |
alias |
|
|
contactgroups |
contactgroup_names |
|
|
minimum_value |
# |
|
|
host_notifications_enabled |
[0/1] |
|
|
service_notifications_enabled |
[0/1] |
|
|
host_notification_period |
timeperiod_name主机故障通知联系人的时间 |
|
|
service_notification_period |
timeperiod_name服务故障通知联系人的时间 |
|
|
host_notification_options |
[d,u,r,f,s,n] |
|
|
service_notification_options |
[w,u,c,r,f,s,n] |
|
|
host_notification_commands |
command_name |
|
|
service_notification_commands |
command_name |
|
|
|
email_address |
|
|
pager |
pager_numberor pager_email_gateway |
|
|
addressx |
additional_contact_address |
|
|
can_submit_commands |
[0/1] |
|
|
retain_status_information |
[0/1] |
|
|
retain_nonstatus_information |
[0/1] |
|
|
} |
||
|
definecontactgroup{ |
||
|
contactgroup_name |
contactgroup_name |
|
|
alias |
alias |
|
|
members |
contacts |
|
|
contactgroup_members |
contactgroups |
|
|
} |
||
|
definetimeperiod{ |
||
|
timeperiod_name |
timeperiod_name |
|
|
alias |
alias |
|
|
[weekday] |
timeranges |
|
|
[exception] |
timeranges |
|
|
exclude |
[timeperiod1,timeperiod2,...,timeperiodn] |
|
|
} |
||
|
definehostescalation{ |
||
|
host_name |
host_name |
|
|
hostgroup_name |
hostgroup_name |
|
|
contacts |
contacts |
|
|
contact_groups |
contactgroup_name |
|
|
first_notification |
#正常规则的第几次通知开始激活这个升级规则。 |
|
|
last_notification |
#0表示升级规则持续到主机正常。 |
|
|
notification_interval |
# |
|
|
escalation_period |
timeperiod_name |
|
|
escalation_options |
[d,u,r] |
|
|
} |
||
|
defineserviceescalation{ |
||
|
host_name |
host_name |
|
|
hostgroup_name |
hostgroup_name |
|
|
service_description |
service_description |
|
|
contacts |
contacts |
|
|
contact_groups |
contactgroup_name |
|
|
first_notification |
# |
|
|
last_notification |
# |
|
|
notification_interval |
# |
|
|
escalation_period |
timeperiod_name |
|
|
escalation_options |
[w,u,c,r] |
|
|
} |
||
|
definehostdependency{ |
||
|
dependent_host_name |
host_name |
|
|
dependent_hostgroup_name |
hostgroup_name |
|
|
host_name |
host_name |
|
|
hostgroup_name |
hostgroup_name |
|
|
inherits_parent |
[0/1] |
|
|
execution_failure_criteria |
[o,d,u,p,n] |
|
|
notification_failure_criteria |
[o,d,u,p,n] |
|
|
dependency_period |
timeperiod_name |
|
|
} |
||
|
defineservicedependency{ |
||
|
dependent_host_name |
host_name |
|
|
dependent_hostgroup_name |
hostgroup_name |
|
|
servicegroup_name |
servicegroup_name |
|
|
dependent_servicegroup_name |
servicegroup_name |
|
|
dependent_service_description |
service_description |
|
|
host_name |
host_name |
|
|
hostgroup_name |
hostgroup_name |
|
|
service_description |
service_description |
|
|
inherits_parent |
[0/1] |
|
|
execution_failure_criteria |
[o,w,u,c,p,n] |
|
|
notification_failure_criteria |
[o,w,u,c,p,n] |
|
|
dependency_period |
timeperiod_name |
|
|
} |
||
command_line中使用宏和参数
$USER1$…
变量宏
$ARG1$…
参数宏
这些宏定义在/usr/local/Nagios/etc/resource.cfg
自定义变量通过下划线_开头，前面有HOST、SERVICE、CONTACT这样的前缀。
通过check_command调用：
check_command command_name\
!$_HOSTNAME1$\
!$_SERVICENAME2$\
!$_SERVICEEXTRA_ARGS$
参数用！分割，
_EXTRA_ARGS直接传插件的选项和参数，多个选项用，分割。
###########################
Hosts:
定义主机
Use决定了使用哪些模板中的基础服务。
Hostgroups决定了这个host特有的服务。
在host的hostgroups里添加services的hostgroup_name就是让host具有这个service。
如果包含的模板中有这个service就不用再添加hostgroups了。
Host中的变量要和service里面调用command的变量一样，去掉HOST就可以了。
###########################
Hostgroups:
主机可以属于任何用户定义的主机组
新建之前需要创建一个hostgroups，然后在templates中调用。
###########################
Services:
定义由主机提供的一个或多个服务
Hostgroup_name中的inc和exc开头的定义在incgroups里面。
Check_command使用！来分隔参数。
hostgroup_name决定了这个服务被哪个组中的host调用。
###########################
Servicegroups：
服务可以属于任何用户定义的分组。
###########################
Contacts：增加nagios的用户
定义具体联系人。
###########################
Contactgroups:
发送通知的对象一般是联系人组，一个联系人可以属于多个组。
###########################
Timeperiods：
定义检查hosts和service的时间
00:00-11:59,12:00-23:59 #使用空格来添加多个时间段.
定义24* 7
表示一直监控。
###########################
Escalations:
升级规则，通过升级规则能使nagios通知另一组联系人。
###########################
denpendency:
依赖关系会基于其它对象的状态过滤某个对象的测试或通知。
###########################