Ansible Role: monitoring-plugins

This role installs a collection of monitoring- or nagios-plugins on different systems.

Requirements & Dependencies

No specific requirements known.

Supported Operating Systems

• ArchLinux
• Debian-based:
  • Debian 10 / 11 / 12
  • Ubuntu 20.04 / 22.04

RedHat-based systems are not officially supported anymore! They may work, but there’s no guarantee.

Configuration

For ArchLinux

monitoring_plugins_arch:
  - monitoring-plugins

For Debian

monitoring_plugins_debian:
  - monitoring-plugins-standard
  - monitoring-plugins-basic
  - monitoring-plugins-common

For RedHat

monitoring_plugins_redhat:
  - nagios-plugins
  - nagios-plugins-disk
  - nagios-plugins-dns
  - nagios-plugins-file_age
  - nagios-plugins-fping
  - nagios-plugins-http
  - nagios-plugins-icmp
  - nagios-plugins-ldap
  - nagios-plugins-load
  - nagios-plugins-mailq
  - nagios-plugins-mysql
  - nagios-plugins-ntp
  - nagios-plugins-ping
  - nagios-plugins-procs
  - nagios-plugins-sensors
  - nagios-plugins-smtp
  - nagios-plugins-snmp
  - nagios-plugins-ssh
  - nagios-plugins-swap
  - nagios-plugins-tcp
  - nagios-plugins-time
  - nagios-plugins-uptime
  - nagios-plugins-users

Remove Plugins

The nagios-plugins-mysql does not work with MariaDB on CentOS 8. (Read this issue)

If needed, you can remove some plugins from the list:

monitoring_plugins_blacklist:
  - nagios-plugins-mysql

Extra Plugins

This role also provides some additional monitoring plugins located in the files directory:

monitoring_plugins_extra:
  - restart_service
  - check_hostname
  - check_diskstat.sh
  - check_uptime.sh
  - check_mem
  - check_requiered_reboot.sh

Download External Plugins

To install external plugins from other Git repositories, use monitoring_plugins_download:

monitoring_plugins_download:
  - url: 'https://gitlab.com/coremedia-as-code/monitoring/monitoring-plugins/raw/master/icinga2/check_coremedia_licenses.py'
    dest: 'check_coremedia_licenses.py'
    checksum: ''
    validate: false
  - url: 'https://raw.githubusercontent.com/bodsch/check_arch_updates/1.0/check_arch_updates'
    dest: 'check_arch_updates'
    checksum: 'sha256:7afa562aaedb63f6e93cfebfa4a9a3ea49fecda62d4dae3d8ff919b76c117c41'

Contribution

Please refer to Contribution.

Development and Branches (Git Tags)

The master branch is my Working Horse and includes the latest updates, but it might sometimes be broken!

For a stable version, please use a Tagged Version.

Author and License

• Bodo Schulz

License

Apache

FREE SOFTWARE, HELL YEAH!