This project provides several plugins for monitoring physical and virtual Linux hosts with Nagios and Nagios-compatible monitoring systems like Icinga and Naemon.
Here is the list of the available plugins:
- check_clock - returns the number of seconds elapsed between local time and Nagios server time
- check_container - checks docker/podman containers
⚠️ pre-alpha, requires libcurl version 7.40.0+ - check_cpu - checks the CPU (user mode) utilization
- check_cpufreq - displays the CPU frequency characteristics
- check_cswch - checks the total number of context switches across all CPUs
- check_fc - monitors the status of the fiber status ports
- check_filecount - checks the number of files found in one or more directories
- check_ifmountfs - checks whether the given filesystems are mounted
- check_intr - monitors the total number of system interrupts
- check_iowait - monitors the I/O wait bottlenecks
- check_load - checks the current system load average
- check_memory - checks the memory usage
- check_multipath - checks the multipath topology status
- check_nbprocs - displays the number of running processes per user
- check_network - displays some network interfaces statistics. The following plugins are symlinks to check_network:
- check_network_collisions
- check_network_dropped
- check_network_errors
- check_network_multicast
- check_paging - checks the memory and swap paging
- check_pressure - checks Linux Pressure Stall Information (PSI) data
- check_readonlyfs - checks for readonly filesystems
- check_selinux - checks if SELinux is enabled 🆕
- check_swap - checks the swap usage
- check_tcpcount - checks the tcp network usage
- check_temperature - monitors the hardware's temperature
- check_uptime - checks how long the system has been running
- check_users - displays the number of users that are currently logged on
The full documentation of the nagios-plugins-linux is available online
in the GitHub wiki page.
This package uses GNU autotools for configuration and installation.
If you have cloned the git repository
git clone --recursive https://github.com/madrisan/nagios-plugins-linux.git
then you will need to run autoreconf --install to generate the required files.
Run ./configure --help to see a list of available install options.
The plugin will be installed by default into LIBEXECDIR.
It is highly likely that you will want to customise this location to suit your needs, i.e.:
./configure --libexecdir=/usr/lib/nagios/plugins
The plugin check_multipath grabs the status of each path by opening a
connection to the multipathd socket. The default value is currently set to
the Linux abstract socket namespace @/org/kernel/linux/storage/multipathd,
but can be modified at build time by using the option --with-socketfile.
Example (RHEL5 and RHEL6 and other old distributions):
./configure --with-socketfile=/var/run/multipathd.sock
If you want to compile the code with a C compiler different from the system default, you can set the environment variable CC accordingly. Here are two examples:
CC=clang-17 ./configure --libexecdir=/usr/lib/nagios/plugins
CC=clang-18 ./configure --libexecdir=/usr/lib/nagios/plugins
After ./configure has completed successfully run make install and
you're done!
You can also run the (still incomplete) set of bundled unit tests by entering
the command make check (or VERBOSE=1 make check) and, if the llvm tool
scan-build is installed on your system, a make -C tests check-clang-checker
to get a static code analysis report (for developers only).
Note: you can also pass the option --enable-libprocps to configure for
getting the informations about memory and swap usage through the API of the
library libproc2.so procps).
This package is written in plain C, making as few assumptions as possible, and sticking closely to ANSI C/POSIX. A C99-compliant compiler is required anyway.
This package is known to compile with:
- gcc 4.1 (RHEL 5 / CentOS 5),
- gcc 4.4 (RHEL6 / CentOS 6),
- gcc 4.8 (RHEL7 / CentOS 7),
- gcc 3.x, 5.1, 5.3, 6.3, 7-14 (openmamba GNU/Linux, Debian 8+, Fedora 25+),
- clang 3.7, 3.8, 4.9, 5, 6, 7, 8, 10-19 (openmamba GNU/Linux, Fedora 25+),
List of the Linux kernels that have been successfully tested:
- 2.6.18, 2.6.32,
- 3.10, 3.14, 3.18,
- 4.2, 4.4, 4,9, 4.14, 4.15, 4.16, 4.19
- 5.6, 5.7, 5.8, 5.12-5.18, 6.1-6.11
The Nagios Plugins Linux are regularly tested on
- Alpine Linux (musl libc),
- Debian, Fedora, Gentoo, and Ubuntu (GNU C Library (glibc)).
The .apk, .rpm and .deb packages for Alpine, CentOS/RHEL, Debian, and Fedora can be built using the following commands
| Command | Distribution |
|---|---|
| Alpine 3.18 | make -C packages alpine-3.18 |
| Alpine 3.19 | make -C packages alpine-3.19 |
| Alpine 3.20 | make -C packages alpine-3.20 |
| CentOS Stream 8 | make -C packages centos-stream-8 |
| CentOS Stream 9 | make -C packages centos-stream-9 |
| Debian 10 (Buster) | make -C packages debian-buster |
| Debian 11 (Bullseye) | make -C packages debian-bullseye |
| Debian 12 (Bookworm) | make -C packages debian-bookworm |
| Fedora 39 | make -C packages fedora-39 |
| Fedora 40 | make -C packages fedora-40 |
| Fedora 41 | make -C packages fedora-41 |
| Fedora Rawhide | make -C packages fedora-rawhide |
| Rocky Linux 8 | make -C packages rockylinux-8 |
| Rocky Linux 9 | make -C packages rockylinux-9 |
in the root source folder. The building process requires the Docker software containerization platform running on your system, and an internet connection to download the Docker images of the operating systems you want to build the packages for.
On Fedora (and all the distributions shipping Podman) you can use the native Podman pod manager along with the Docker CLI emulation script:
sudo install dnf podman podman-docker
Note: the previous make commands can end with a permission denied error if selinux is configured in enforcing mode.
In this case you can temporarily disable selinux by executing as root the command setenforce 0
(or maybe share a better solution!).
The Nagios Plugin Linux source code has been merged with the Debian package nagios-plugins-contrib
but only the check_memory plugin is provided by the binary package shipped by Debian,
starting with the Debian Bookworm version.
For more details, see GitHub discussion #147.
The plugins are available in the Gentoo tree. They can be installed by running:
emerge -av net-analyzer/nagios-plugins-linux-madrisan
The USE flag curl is required to build check_container.
If you find a bug please create an issue in the project bug tracker at GitHub