Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bodsch/ansible-monitoring-plugins

handle the monitoring- or nagios-plugins
https://github.com/bodsch/ansible-monitoring-plugins

ansible ansible-role monitoring monitoring-plugins nagios-plugins

Last synced: 7 days ago
JSON representation

handle the monitoring- or nagios-plugins

Host: GitHub
URL: https://github.com/bodsch/ansible-monitoring-plugins
Owner: bodsch
License: apache-2.0
Created: 2020-09-27T13:30:14.000Z (about 4 years ago)
Default Branch: main
Last Pushed: 2024-08-19T14:53:01.000Z (3 months ago)
Last Synced: 2024-08-20T12:14:35.627Z (3 months ago)
Topics: ansible, ansible-role, monitoring, monitoring-plugins, nagios-plugins
Language: Perl
Homepage:
Size: 152 KB
Stars: 3
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

# Ansible Role: `monitoring-plugins`

installs an set of `monitoring-` or `nagios-plugins` on various systems.

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/bodsch/ansible-monitoring-plugins/main.yml?branch=main)][ci]
[![GitHub issues](https://img.shields.io/github/issues/bodsch/ansible-monitoring-plugins)][issues]
[![GitHub release (latest by date)](https://img.shields.io/github/v/release/bodsch/ansible-monitoring-plugins)][releases]
[![Ansible Downloads](https://img.shields.io/ansible/role/d/bodsch/monitoring_plugins?logo=ansible)][galaxy]

[ci]: https://github.com/bodsch/ansible-monitoring-plugins/actions
[issues]: https://github.com/bodsch/ansible-monitoring-plugins/issues?q=is%3Aopen+is%3Aissue
[releases]: https://github.com/bodsch/ansible-monitoring-plugins/releases
[galaxy]: https://galaxy.ansible.com/ui/standalone/roles/bodsch/monitoring_plugins/

## Requirements & Dependencies

not known

### Operating systems

* ArchLinux
* Debian based
- Debian 10 / 11 / 12
- Ubuntu 20.04 / 22.04

> **RedHat-based systems are no longer officially supported! May work, but does not have to.**

## configuration

### archlinux based

```yaml
monitoring_plugins_arch:
- monitoring-plugins
```

### debian based

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

### redhat based

```yaml
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 monitoring plugins from list

`nagios-plugins-mysql` and MariaDB from epel are not compatible in CentoOS 8.
([read this issue](https://github.com/Icinga/icinga2/issues/7927))

If necessary, some of the plugins can be removed from the previously defined list:

```yaml
monitoring_plugins_blacklist:
- nagios-plugins-mysql
```

### extra plugins

This role provides some small monitoring plugins.
These are located in the [files](./files) directory:

```yaml
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, you can use `monitoring_plugins_download`:

```yaml
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 read [Contribution](CONTRIBUTING.md)

## Development, Branches (Git Tags)

The `master` Branch is my *Working Horse* includes the "latest, hot shit" and can be complete broken!

If you want to use something stable, please use a [Tagged Version](https://github.com/bodsch/ansible-monitoring-plugins/tags)!

---

## Author and License

- Bodo Schulz

## License

[Apache](LICENSE)

**FREE SOFTWARE, HELL YEAH!**