NSCA 被动模式插件

  • 版本 2.9.x

  • 需要安装 nagios

  • 调用流程

    • 远程主机 send_nsca 插件 -> nagios 主机上的 NSCA daemon 服务

  • 组成结构

    • send_nsca : 客户端插件, 安装在远程主机上, 用法发送指定格式的数据到 NSCA daemon 服务上
    • NSCA daemon : 运行在 Nagios 主机上的守护服务

一、部署 NSCA daemon 服务

  1. 1. 创建账号
  2. # 创建 nagios 账号, 并且分配 nagios 到 nagios 组中
  3. useradd nagios
  4. usermod -a -G nagios nagios
  7. 2. 下载 NSCA(Nagios 主机)
  8. # 下载
  9. cd /usr/local/src
  10. sudo wget https://nchc.dl.sourceforge.net/project/nagios/nsca-2.x/nsca-2.9.2/nsca-2.9.2.tar.gz
  11. sudo tar -zxvf nsca-2.9.2.tar.gz
  13. # 编译
  14. cd nsca-2.9.2
  15. ./configure
  16. make all
  18. # 出现如下信息
  19. NSCA port:  5667
  20. NSCA user:  nagios
  21. NSCA group: nagios
  23. # 编译检查正确执行以后, 会出现如下信息
  24. src/ 目录下生成两个程序 nsca(服务进程)  send_nsca(客户端)
  25. sample-config/ 中会有 nsca.cfg 和 send_nsca.cfg 的配置文件
  28. 3. 部署 NSCA 和配置文件
  29. # 部署 NSCA (send_nsca 和 nsca)
  30. cp src/send_nsca src/nsca /usr/local/nagios/bin/
  31. chown nagios:nagios /usr/local/nagios/bin/nsca /usr/local/nagios/bin/send_nsca
  33. # 部署配置文件
  34. mkdir -p /usr/local/nagios/etc/nsca
  35. cp sample-config/* /usr/local/nagios/etc/nsca/
  36. chown nagios:nagios /usr/local/nagios/etc/nsca/*
  39. 4. NSCA daemon 配置
  40. # 修改配置文件: etc/nsca/nsca.cfg
  41. vim etc/nsca/nsca.cfg
  43. # 端口
  44. server_port=5667
  46. # 监听地址
  47. server_address=0.0.0.0
  49. # 开启 debug 模式, 用于调试。部署的时候调整到 debug=0
  50. debug=1
  52. # 命令文件, 这是守护进程的 Nagios 命令文件的位置
  53. # 注意文件路径
  54. command_file=/usr/local/nagios/var/rw/nagios.cmd
  56. # 备用转储文件, 这是用来指定守护进程应该的另一个文件
  57. # 注意文件路径
  58. alternate_dump_file=/usr/local/nagios/var/rw/nsca.dump
  60. # 聚合写选项
  61. aggregate_writes=1
  63. # password: 通讯密码, 与 send_nsca 客户端定义相同的密码, send_nsca 的配置文件在 etc/nsca/send_nsca.cfg
  64. password=xxxx.com
  67. 5. NSCA daemon 启动服务
  68. # 语法 bin/nsca --help
  69. Usage: bin/nsca -c <config_file> [mode]
  70. Options:
  71.  <config_file> = Name of config file to use
  72.  [mode]        = Determines how NSCA should run. Valid modes:
  73.    --inetd     = Run as a service under inetd or xinetd
  74.    --daemon    = Run as a standalone multi-process daemon
  75.    --single    = Run as a standalone single-process daemon (default)
  77. # 启动服务
  78. /usr/local/nagios/bin/nsca -c /usr/local/nagios/etc/nsca/nsca.cfg --single
  80. # 监控日志
  81. tail -f /var/log/message
  83. # 查看进程是否存在
  84. ps -axu | grep nsca
  86. # 查看端口是否存在
  87. netstat -tunlp | grep 5667

二、 Nagios 与 NSCA daemon 服务打通

  1. 1. Nagios 在 services 配置 nsca 脚本
  2. # 修改配置文件
  3. vim etc/objects/services.cfg
  5. # 定义 service, 使用 check_dummy 插件, 接收 send_nsca 客户端发送过来的数据
  6. define service{
  7.         # 使用的模板
  8.         use                     service_nsca_template
  10.         # 定义用于接收 send_nsca 信息的主机名
  11.         host_name               serverTest
  12.         # 定义用于接收 send_nsca 信息的主机描述
  13.         service_description     nscaTest
  14.         # 定义 <脚本名称> check_dummy, 用于处理 send_nsca 发送来的数据
  15.         # check_dummy: 这个脚本, 就是 commands.cfg 配置中定义的<脚本名称>
  16.         check_command           check_dummy!0
  17.         # 是否发送通知
  18.         notifications_enabled   1
  20.         contact_groups          MonitorGroup
  21. }
  24. 2. Nagios 在 commands 配置 nsca <脚本名称>
  25. # 修改配置文件
  26. vim etc/objects/commands.cfg
  28. # 定义 commands, 定义 <脚本名称> check_dummy, 处理 send_nsca 客户端发送过来的数据
  29. # check_dummy: 插件是一个简单的翻译插件, 只能处理 4 个参数状态分别是 0,1,3,663, 对应了 (OK、WARNING、CRITICAL、UNKNOWN), 例如: check_dummy 0 对应就是 OK
  30. define command{
  31.         command_name    check_dummy
  32.         command_line    $USER1$/check_dummy $ARG1$
  33. }
  36. 3. 重启 nagios 服务
  37. service nagios restart

二、send_nsca 远程主机部署

  1. # 语法 bin/send_nsca --help
  2. Usage: bin/send_nsca -H <host_address> [-p port] [-to to_sec] [-d delim] [-c config_file]
  4. Options:
  5.  <host_address> = The IP address of the host running the NSCA daemon
  6.  [port]         = The port on which the daemon is running - default is 5667
  7.  [to_sec]       = Number of seconds before connection attempt times out.
  8.                   (default timeout is 10 seconds)
  9.  [delim]        = Delimiter to use when parsing input (defaults to a tab)
  10.  [config_file]  = Name of config file to use
  12. Service Checks:
  13.  <host_name>[tab]<svc_description>[tab]<return_code>[tab]<plugin_output>[newline]
  15. Host Checks:
  16.  <host_name>[tab]<return_code>[tab]<plugin_output>[newline]
  19. # 案例: 发送数据到 NSCA daemon 中, 注意其中的 serverTest,nscaTest 必须与 services.cfg 中定义的 service 相同, 才可接受到数据
  20. echo -e "serverTest,nscaTest,0,test" | bin/send_nsca -H dw0 -p 5667 -c /usr/local/nagios/etc/nsca/send_nsca.cfg -d ","