概述
Nagios可以使用邮件报警，但是如果使用IM软件提供的API进行报警的话，时效性上来说必然是会更好的。
另外如果使用自定义的报警脚本，可以针对报警做更多的事情，譬如限频，异步发送，记录入库等操作。
总而言之就是可以拥有更为灵活的工具。
关键点
开发语言
众多的Nagios插件均使用Perl编写，如 监控Redis 中使用到的工具。
选用Perl语言对于我来说并不是一个好的选择，如果选用了Perl，那么在主要使用PHP的环境下，不能方便的重复利用已有框架的各种工具，同时从语言的熟悉程度上来说，自然是PHP胜过Perl。
综上，选用PHP作为插件开发语言。
选用PHP作为Nagios报警插件的开发语言，需要在脚本的首行指定 Shebang ，即指定PHP可执行程序的绝对路径，形如：
|
1 |
#!/usr/local/server/bin/php |
Shebang之下仍然需要使用 <?php 标签。
同时，为了能让Nagios能直接执行报警插件，需要赋予可执行权限：
|
1 |
chmod a+x /path/to/your/nagios/plugin |
脚本输入输出
输入
脚本的输入方式与普通的命令行工具并无太多区别，可以使用 getopt 来获取输入的参数。
由于需要实现限频，以及针对主机和服务做一些处理，定义了如下的参数：
| 参数 | 说明 |
|---|---|
u |
通知用户 |
m |
报警消息体 |
r |
频率限制值，秒为单位 |
h |
主机 |
p |
端口 |
l |
通知等级，即OK/CRITICAL/WARNING/UNKNOW等 |
n |
通知类型，即PROBLEM/CUSTOM等 |
|
1 2 3 4 5 6 7 8 9 |
$options = getopt('u:m:r:h:s:l:n:'); $warning_users = isset($options['u']) ? $options['u'] : ''; $message = isset($options['m']) ? $options['m'] : ''; $rate = isset($options['r']) ? $options['r'] : 0; $host = isset($options['h']) ? $options['h'] : ''; $service = isset($options['s']) ? $options['s'] : ''; $level = isset($options['l']) ? $options['l'] : NOTIFICATION_LEVEL_NOTICE; $notification_type = isset($options['n']) ? $options['n'] : NOTIFICATION_TYPE_PROBLEM; |
限频的目的在于防止接收过多信息，避免必须处理的信息无法及时被发现。
而针对服务恢复正常的信息，不需要限频。
输出
Nagios的插件通过返回值确定这次检验的状态，即：
| Exit code | 状态 |
|---|---|
| 0 | OK |
| 1 | WARNING |
| 2 | CRITICAL |
| 3 | UNKNOWN |
不过由于是报警脚本，不妨直接让脚本返回0吧。
自定义变量
Nagios在调用编写的报警脚本时，通过定义好的command格式，完成传参。
对应到每一个联系人，需要有变量告知联系人的联系方式，针对IM，比如QQ，自然是QQ号。查阅Nagios预定义宏，会发现并没有QQ号这样的预定义宏。
当然可以选用预定义的 CONTACTPAGER 。考虑到寻呼机已经几乎没人使用了，可以借用一下变量。
针对各种工具（IM/内部通信接口/短信平台接口等），需要自定义。
关于自定义，Nagios的文档已有说明，这里简单提及一下：
- 自定义变量必须以
_开头以防止与预定义变量冲突 - 自定义变量使用时需要转为全大写
- 自定义变量会在前方加上所属的对象类型
针对第三点，简单说来，针对Contact，即联系人这一对象，如果定义了名为uid的自定义变量，那么，在contact的配置中，需要写成_uid，而实际在配置command时，会变为$_CONTACTUID$。
配置commands
新增一个发送报警命令send_pm，定义这一自定义报警的调用方式。
|
1 2 3 4 5 6 |
# 'send_pm' is an alert command define command { command_name send_pm command_line /path/to/your/own/plugins/send_pm.php -h $HOSTADDRESS$ -u $_CONTACTUID$ -l $SERVICESTATE$ -s $SERVICEDISPLAYNAME$ -m "$HOSTADDRESS$|$ SERVICEDISPLAYNAME$|$SERVICEOUTPUT$" -n $NOTIFICATIONTYPE$ -r 300 } |
参数列表正如上文提及的。
报警内容为了简短，只会发送主机名、服务名称以及检查结果的首行。
配置contacts
在需要报警的联系人配置中，加上自定义的uid变量，以及指定报警方法：
|
1 2 3 |
service_notification_commands send_pm,notify-service-by-email host_notification_commands send_pm,notify-service-by-email _uid 9527 |
以上。
