mabitt/nrpe-server

docker-nrpe-server 镜像文档

镜像概述

docker-nrpe-server是一个在Docker容器中运行的Nagios NRPE（Nagios Remote Plugin Executor）服务器镜像。NRPE允许Nagios服务器远程执行监控插件，从而监控远程主机的系统资源和服务状态。该镜像提供了便捷的配置方式和内置监控插件，适用于容器化环境下的主机和Docker容器监控。

核心功能与特性

• 灵活的Nagios服务器配置：通过环境变量NAGIOS_SERVER指定允许连接的Nagios服务器IP地址
• 自定义配置支持：可挂载本地配置文件目录到容器，实现监控命令的个性化配置
• Docker容器监控：支持通过挂载Docker socket实现对容器状态的监控
• 内置常用监控命令：包含系统负载、磁盘空间、内存使用及Docker容器检查等基础监控命令

使用场景

• 监控物理机或虚拟机的系统资源（负载、磁盘、内存）
• 监控Docker主机上运行的容器状态
• 作为Nagios监控系统的远程执行代理，扩展监控范围
• 容器化部署NRPE服务，简化服务配置与维护

使用方法

基本运行（系统资源监控）

运行包含基础系统监控（负载、磁盘、内存）的NRPE服务器：

shell
docker run -d --name nrpe-server -p 5666:5666 -e "NAGIOS_SERVER=10.0.0.1" mabitt/nrpe-server

启用Docker容器监控

如需监控Docker容器，需挂载Docker socket：

shell
docker run -d --name nrpe-server -p 5666:5666 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e "NAGIOS_SERVER=0.0.0.0" \
  mabitt/nrpe-server

挂载自定义配置文件

挂载本地配置目录以添加或覆盖监控命令：

shell
docker run -d --name nrpe-server -p 5666:5666 \
  -e "NAGIOS_SERVER=10.0.0.1" \
  -v /srv/nrpe-server/nrpe.d:/etc/nagios/nrpe.d \
  mabitt/nrpe-server

配置说明

环境变量

挂载点

内置监控命令

容器内置配置文件/etc/nagios/nrpe_local.cfg包含以下监控命令：

shell
# 系统负载监控：警告阈值15,10,5， critical阈值30,25,20
command[check_load]=/usr/lib/nagios/plugins/check_load -w 15,10,5 -c 30,25,20

# 磁盘空间监控：警告阈值20%，critical阈值10%
command[check_disk]=/usr/lib/nagios/plugins/check_disk -w 20% -c 10%

# 内存使用监控：警告阈值500MB，critical阈值100MB
command[check_mem]=/usr/lib/nagios/plugins/check_mem.sh -w 500 -c 100 -p

# Docker容器名称监控：检查指定名称的容器状态
command[check_docker_name]=/usr/lib/nagios/plugins/check_docker_name.sh --name $ARG1$

# Docker容器服务监控：检查指定名称容器的CPU/内存使用，参数为名称、警告阈值、critical阈值
command[check_docker_service]=/usr/lib/nagios/plugins/check_docker_service.sh --name $ARG1$ --warn $ARG2$ --crit $ARG3$