nagios/passive_check | 易学教程

术语

被监控机（MC：Monitor Client）
监控机（MS：Monitor Server）

被动模式工作原理：

在被 MC 上面，使用nagios-plugins提供的插件，得出监数据，将数据发送到 MS 端,MS上面运行的daemon(常见的是nsca,或 nrdp，mod_gearman )用来接收这些数据,按照预定义的格式传递给nagios，nagios核心进程将会对数据进行处理（前台展示，警报）。

nsca 插件采用的是将检测结果写入外部命令文件，该文件是一个管道文件，也是nagios主程序的一个接口（用来接收监控数据），（ubuntu14.04 nagios 默认配置是 “/var/lib/nagios3/rw/nagios.cmd”）；
nrdp 插件除了将检测结果写入外部命令文件,还可以将检测结果直接写入到Nagios内核的spool目录，（ubuntu14.04 nagios 默认配置是 “/var/lib/nagios3/spool/checkresults”）；
mod_gearman 使用事件代理模式，会将结果注入nagios结果环形缓冲区数据结构中，不会被FIFO的IO限制

原理图

在此输入图片描述

优缺点

优点：相比与主动模式，被动模式能很大程度地降低nagios负载

缺点：当监控的主机规模进一步扩大，会被"外部命令文件"I/O局限所拖累，（事件代理模式除外）

nagios 配置

注意：（本文是ubuntu14.04为基础环境，创建被动模式的配置，以下分别用术语中定义的简称 MS,MC）

开启被动监控

/etc/nagios3/nagios.cfg

<pre> check_external_commands = 1 (enable commands file) # 允许检测结果写入外部命令文件 command_check_interval = -1 (check the external command file as often as possible) </pre>

定被模板

添加模板，修改配置文件 template.cfg，添加如下内容：

<pre> define service{ name passive_service use generic-service max_check_attempts 1 active_checks_enabled 0 #（关闭主动检测） passive_checks_enabled 1 #（开启被动检测） normal_check_interval 5 retry_check_interval 1 check_freshness 1 # (开启强制刷新) notifications_enabled 1 notification_interval 5 notification_period 24x7 contact_groups admins register 0 #（必须） } </pre>

定义被动监控指令

/etc/nagios3/commands.cfg

<pre> define command { command_name check_dummy command_line /usr/lib/nagios/plugins/check_dummy $ARG1$ $ARG2$ } </pre>

check_dummy指令实际上不检查任何东西，指定两个参数，一个是状态，一个是输出，始终返回这两个参数。

<pre> # /usr/lib/nagios/plugins/check_dummy 0 successful OK: successful # /usr/lib/nagios/plugins/check_dummy 1 failed WARNING: failed # /usr/lib/nagios/plugins/check_dummy 2 failed CRITICAL: failed # /usr/lib/nagios/plugins/check_dummy 3 failed UNKNOWN: failed </pre>

定义要被动监控的主机

<pre> define service { use passive_service host_name localhost service_description check_disk_passive freshness_threshold 86400 # 主服务端强制刷新的时间(s) check_command check_dummy!1!"Check failed No return data for 24 hours } </pre>

被动检测提交的格式：

主机检测格式：    [<timestamp>] PROCESS_HOST_CHECK_RESULT;<host_name>;<host_status>;<plugin_output>

<pre> timestamp： unix时间戳 PROCESS_HOST_CHECK_RESULT 外部命令 host_name：监控的主机地址 host_status：主机的状态（ 0 = OK，1 = WARNING，2 =CRITICAL，3 = UNKNOWN） plugin_output：主机检查的文本输出 </pre>

服务检测格式：    [<timestamp>] PROCESS_SERVICE_CHECK_RESULT;<host_name>;<svc_description>;<return_code>;<plugin_output>

<pre> timestamp： unix时间戳 PROCESS_SERVICE_CHECK_RESULT 外部命令 host_name：监控的主机地址 svc_description：服务的描述名称(与nagios服务端配置定义的必须一致) return_code：服务的状态（ 0 = OK，1 = WARNING，2 =CRITICAL，3 = UNKNOWN） plugin_output：主机检查的文本输出如： </pre>

通过外部命令文件提交结果

外部应用程序可以通过向外部命令文件写入检测结果：

<pre> # echo "[`date +%s`] PROCESS_HOST_CHECK_RESULT;mc_hostname;0;ping is ok" >> /var/lib/nagios3/rw/nagios.cmd # echo "[`date +%s`] PROCESS_SERVICE_CHECK_RESULT;mc_hostname;check_ssh_passive;0;test is ok " >> /var/lib/nagios3/rw/nagios.cmd </pre>

nrdp 的提交方式

外部应用程序可以向 Nagios内核的spool目录写入存放检测结果的文件（ubuntu14.04 nagios 默认配置是 "/var/lib/nagios3/spool/checkresults"）：

主机检测结果文件：cpjCd4i ### NRDP Check ### start_time=1415871546.0 # Time: Thu, 13 Nov 2014 09:39:06 +0000 host_name=cdn-gc-dongguan1 check_type=1 early_timeout=1 exited_ok=1 return_code=0 output=Everything looks okay!|perfdata\n

服务检测结果文件：clNVC3S ### NRDP Check ### start_time=1415871546.0 # Time: Thu, 13 Nov 2014 09:39:06 +0000 host_name=cdn-gc-dongguan1 service_description=SSH check_type=1 early_timeout=1 exited_ok=1 return_code=1 output=WARNING: Danger Will Robinson!|perfdata\n

通过mod_gearman提交结果

当nagios加载 broker_module=/usr/lib/mod_gearman/mod_gearman.o 后，会在gearman-job-server中创建一个名为check_results 的任务队列，client请求任务，worker 处理后，最终将结果写入check_results 的任务队列，mod_gearman.o 取回结果传递给nagios核心进程，完成一次任务的分发处理。

以python_gearman 编程接口为例,（这货貌似好久没有更新了，也不支持加密传输）

#!/usr/bin/env python

import gearman

gm_client = gearman.GearmanClient(['localhost:4730'] )
completed_job_request = gm_client.submit_job("check_results", "type=passive host_name=cdn-tx-wuhan-ctc3 core_start_time=1415807730.0 start_time=1415807730.19546  finish_time=1415807730.105364 return_code=2 exited_ok=0 output=PING_OK\n")

mod_gearman C源码片断

gearman_util.c

提交结果的主要部分:
add_job_to_queue(...) 
{
   task = gearman_client_add_task_low_background( client, NULL, NULL, queue, uniq, ( void * )crypted_data, ( size_t )size, &ret1 );
    gearman_task_give_workload(task,crypted_data,size);
}

参考

来源：oschina

链接：https://my.oschina.net/u/877567/blog/325881

标签

nagios

lib文件

host

gearman