Linuxfabrik /monitoring-plugins

Monitoring plugins for Icinga, Nagios & friends. Python 3.9+, all platforms. Smart defaults, auto-discovery, consistent cross-platform metrics, minimal dependencies.

★ 299⑂ 70👁 13⑃ 773● 874▤ 39
PythonUnlicenseCreated 2022-03-01linuxfabrik.ch
Download: v8.1.0v8.1.0 ↓8.1.02026-10-27
+0
Daily
299
stars
70
forks
13
watchers
773
prs
874
issues
39
releases

README

Linuxfabrik Monitoring Plugins


  Monitoring plugins for Icinga, Nagios & friends. Python 3.9+, all platforms. Smart defaults, auto-discovery, consistent cross-platform metrics, minimal dependencies.
  &8226;
  made by Linuxfabrik



!GitHub Stars
!GitHub
!Version
!Python
!Platforms
!GitHub Issues










 The Linuxfabrik Monitoring Plugins Collection

Nagios-compatible check plugins for Icinga, Naemon, Nagios and any other monitoring system that speaks the Nagios plugin API. Each plugin is a stand-alone CLI that reports one type of check: fast, consistent across platforms, minimal dependencies, reasonable defaults so WARN and CRIT only fire when it really matters.

 If these plugins help you monitoring your datacenter, your VMs or your applications, please give it a star.

Written in Python, released into the public domain under the UNLICENSE. Runs on any platform with Python 3.9+ (Linux, Windows, macOS, FreeBSD). For Windows we also ship pre-compiled binaries, so Python is not required on the target.


 Documentation

Full documentation is available at linuxfabrik.github.io/monitoring-plugins. It is automatically built and deployed on every push to main.

For a visual tour of what plugins look like in Icinga Web 2, see POSTER.md.


 Try it Live

A public demo with the plugins wired into Icinga Web 2 and Grafana:
icinga-demo.linuxfabrik.ch.


 Installation

On Linux, set up our signed package repository with the linuxfabrik-release package as described on repo.linuxfabrik.ch, then install the package, for example on RHEL:

bash
sudo dnf --assumeyes install linuxfabrik-monitoring-plugins-selinux


On Windows, install with the one-liner in an elevated PowerShell. It downloads the signed MSI, verifies its Authenticode signature and installs it silently:

powershell
& ([scriptblock]::Create((irm https://repo.linuxfabrik.ch/install-monitoring-plugins.ps1)))


Then run a plugin directly to verify it works, for example on Linux:

text
$ /usr/lib64/nagios/plugins/cpu-usage
5.1% - user: 3.0%, system: 1.0%, irq: 0.5%, softirq: 0.5%
guest: 0.0%, guest_nice: 0.0%, iowait: 0.0%, nice: 0.0%, steal: 0.0%
ctx_switches: 8.5G, interrupts: 6.8G, soft_interrupts: 1.7G


Every plugin supports --help and prints its version with --version.

For more installation paths, see INSTALL.md: the commands for SLE, Debian and Ubuntu, the Linux one-liner that sets up the repository and installs the package in one step, the LFOps Ansible role for fleets (Linux and Windows), the manual MSI download on Windows, reviewing the installer against its published sha256 checksum before running it, the source install for running the latest state in production, air-gapped and per-distribution setups, sudoers drop-ins and SELinux.

Plugins that share setup steps:

 File plugins
 Keycloak plugins
 MySQL / MariaDB plugins
 QNAP plugins
 Rocket.Chat plugins
 WildFly / JBoss EAP plugins
 Windows plugins that need more rights


 OS Compatibility

| Family            | Tested releases         

Top issues

Discussions

Latest release

v8.1.0 v8.1.0 2026-10-27
Release Notes/CHANGELOG at https://github.com/Linuxfabrik/monitoring-plugins/blob/main/CHANGELOG.md

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON