Nagios-MongoDB 监控脚本技术文档

概述

Nagios-MongoDB 是一个简单的 Nagios 检查脚本，用于监控 MongoDB 服务器。该脚本可以帮助用户监控 MongoDB 的各种状态，如连接状态、内存使用、锁时间、复制延迟等。

作者

主要作者

• Mike Zupan <mike -at- zcentric.com>

贡献者

• Frank Brandewiede <brande -at- travel-iq.com> <brande -at- bfiw.de> <brande -at- novolab.de>
• Sam Perman <sam -at- brightcove.com>
• Shlomo Priymak <shlomoid -at- gmail.com>
• @jhoff909 on github
• Dag Stockstad <dag.stockstad -at- gmail.com>

安装指南

安装步骤

1. 在 Nagios 插件目录中运行以下命令克隆项目：

   git clone git://github.com/mzupan/nagios-plugin-mongodb.git
   

2. 使用 pip 安装所有依赖项：

   pip install -r requirements
   

项目使用说明

在 Nagios 中安装

1. 编辑 commands.cfg 文件，添加以下命令定义：

   define command {
       command_name    check_mongodb
       command_line    $USER1$/nagios-plugin-mongodb/check_mongodb.py -H $HOSTADDRESS$ -A $ARG1$ -P $ARG2$ -W $ARG3$ -C $ARG4$
   }
   
   define command {
       command_name    check_mongodb_database
       command_line    $USER1$/nagios-plugin-mongodb/check_mongodb.py -H $HOSTADDRESS$ -A $ARG1$ -P $ARG2$ -W $ARG3$ -C $ARG4$ -d $ARG5$
   }
   
   define command {
       command_name    check_mongodb_collection
       command_line    $USER1$/nagios-plugin-mongodb/check_mongodb.py -H $HOSTADDRESS$ -A $ARG1$ -P $ARG2$ -W $ARG3$ -C $ARG4$ -d $ARG5$ -c $ARG6$
   }
   
   define command {
       command_name    check_mongodb_replicaset
       command_line    $USER1$/nagios-plugin-mongodb/check_mongodb.py -H $HOSTADDRESS$ -A $ARG1$ -P $ARG2$ -W $ARG3$ -C $ARG4$ -r $ARG5$
   }
   
   define command {
       command_name    check_mongodb_query
       command_line    $USER1$/nagios-plugin-mongodb/check_mongodb.py -H $HOSTADDRESS$ -A $ARG1$ -P $ARG2$ -W $ARG3$ -C $ARG4$ -q $ARG5$
   }
   

2. 在 services.cfg 中引用这些命令，例如：

   define service {
       use                 generic-service
       hostgroup_name          Mongo Servers
       service_description     Mongo Connect Check
       check_command           check_mongodb!connect!27017!2!4
   }
   

项目API使用文档

检查连接

检查每个 MongoDB 服务器的连接状态，如果连接时间超过 2 秒发出警告，超过 4 秒发出严重错误。

define service {
    use                 generic-service
    hostgroup_name          Mongo Servers
    service_description     Mongo Connect Check
    check_command           check_mongodb!connect!27017!2!4
}

检查开放连接百分比

检查 MongoDB 服务器上剩余的连接百分比，如果连接池使用率达到 70% 发出警告，80% 发出严重错误。

define service {
    use                 generic-service
    hostgroup_name          Mongo Servers
    service_description     Mongo Free Connections
    check_command           check_mongodb!connections!27017!70!80
}

检查复制延迟

检查 MongoDB 服务器的复制延迟，如果延迟超过 15 秒发出警告，超过 30 秒发出严重错误。

define service {
    use                 generic-service
    hostgroup_name          Mongo Servers
    service_description     Mongo Replication Lag
    check_command           check_mongodb!replication_lag!27017!15!30
}

检查内存使用

检查 MongoDB 服务器的内存使用情况，如果使用超过 20GB 发出警告，超过 28GB 发出严重错误。

define service {
    use                 generic-service
    hostgroup_name          Mongo Servers
    service_description     Mongo Memory Usage
    check_command           check_mongodb!memory!27017!20!28
}

项目安装方式

通过 Git 安装

1. 克隆项目到 Nagios 插件目录：

   git clone git://github.com/mzupan/nagios-plugin-mongodb.git
   

2. 安装依赖：

   pip install -r requirements
   

在 Nagios 中配置

编辑 commands.cfg 和 services.cfg 文件，添加相应的命令和服务定义。