311 lines
18 KiB
Markdown
311 lines
18 KiB
Markdown
# Xymon
|
||
|
||
1. [Overview](#overview)
|
||
2. [Role Variables](#role-variables)
|
||
* [Plugins Specific Variables](#plugins-variables)
|
||
* [OS Specific Variables](#os-specific-variables)
|
||
3. [Example Playbook](#example-playbook)
|
||
4. [Configuration](#configuration)
|
||
4. [Plugins](#plugins)
|
||
6. [Development](#development)
|
||
7. [License](#license)
|
||
8. [Author Information](#author-information)
|
||
|
||
## Overview
|
||
|
||
Manage Xymon (client) installation and configuration.
|
||
|
||
## Role Variables
|
||
|
||
* **xymon_cli__manage** : If `xymon-client` should be managed with this role [default : `true`].
|
||
* **xymon_cli__pkg_state** : State of new `xymon-client` package(s) [default : `present`].
|
||
* **xymon_cli__default_conf_path** : Configuration file for `xymon-client` [default : `/etc/default/xymon-client`].
|
||
* **xymon_cli__default_conf_tpl** : Template used to generate the previous config file [default : `etc/default/xymon-client.j2`].
|
||
* **xymon_cli__hostname** : Allow to override default value of CLIENTHOSTNAME var [default : `{{ ansible_fqdn }}`].
|
||
* **xymon_cli__user_groups** : List of 'xymon' user's groups [default : `xymon`].
|
||
* **xymon_cli__service_manage** : If `xymon-client` service should be managed with this role [default : `true`].
|
||
* **xymon_cli__service_name** : `xymon-client` service name [default : `xymon-client`].
|
||
* **xymon_cli__service_enabled** : Set `xymon-client` service available at startup [default : `true`].
|
||
* **xymon_cli__srv_list** : The list of Xymon servers (you must give an hostname, IP,… reachable from any clients) [defaults : `monitoring.{{ ansible_domain }}`].
|
||
* **xymon_cli__plug_manage** : If this role should manage plugins configuration [default : `true`].
|
||
|
||
### Plugins Variables
|
||
|
||
* **xymon_cli__plug_combined_packages** : Combine all packages vars related to plugins (only enabled plugins).
|
||
* **xymon_cli__plug_combined_clientlaunch** : Combine clientlaunch files for all plugins.
|
||
|
||
#### APT
|
||
|
||
Variables for the APT plugin from hobbit-plugins. The plugin check for
|
||
outstanding updates.
|
||
|
||
* **xymon_cli__plug_apt_state** : The state of plugin `apt` [default : `true`].
|
||
* **xymon_cli__plug_apt_package** : The packages to install to provide `apt` plugin [default : `[ 'libtimedate-perl' ]`].
|
||
* **xymon_cli__plug_apt_path** : Configuration file for the `apt` plugin [default : `/etc/xymon/clientlaunch.d/apt.cfg`].
|
||
* **xymon_cli__plug_apt_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/apt.cfg.j2`].
|
||
* **xymon_cli__plug_apt_interval** : Time between each run of the `apt` plugin [default : `5m`].
|
||
* **xymon_cli__plug_apt_default_whitelist** : Default list of allowed packages not installed from repositories [default : `[]`].
|
||
* **xymon_cli__plug_apt_whitelist** : All hosts list of allowed packages not installed from repositories [default : `[]`].
|
||
* **xymon_cli__plug_apt_group_whitelist** : Group list of allowed packages not installed from repositories [default : `[]`].
|
||
* **xymon_cli__plug_apt_host_whitelist** : Host list of allowed packages not installed from repositories [default : `[]`].
|
||
|
||
#### IPMI
|
||
|
||
Variables for the IPMI plugin from hobbit-plugins. The plugin read IPMI
|
||
sensors and event log.
|
||
|
||
* **xymon_cli__plug_ipmi_state** : The state of plugin `ipmi` [default : `false`].
|
||
* **xymon_cli__plug_ipmi_state** : The packages to install to provide `ipmi` plugin [default : `[ 'ipmitool' ]`].
|
||
* **xymon_cli__plug_ipmi_path** : Configuration file for the `ipmi` plugin [default : `/etc/xymon/clientlaunch.d/ipmi.cfg`].
|
||
* **xymon_cli__plug_ipmi_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/ipmi.cfg.j2`].
|
||
* **xymon_cli__plug_ipmi_interval** : Time between each run of the `ipmi` plugin [default : `5m`].
|
||
|
||
#### Kern
|
||
|
||
Variables for the kern plugin from hobbit-plugins. The plugin check for running
|
||
outdated running kernel and need for reboot.
|
||
|
||
* **xymon_cli__plug_kern_state** : The state of plugin `kern` [default : `true`].
|
||
* **xymon_cli__plug_kern_package** : The packages to install to provide `kern` plugin [default : `[ 'binutils', 'libfile-slurp-perl', 'libsort-naturally-perl' ]`].
|
||
* **xymon_cli__plug_kern_path** : Configuration file for the `kern` plugin [default : `/etc/xymon/clientlaunch.d/kern.cfg`].
|
||
* **xymon_cli__plug_kern_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/kern.cfg.j2`].
|
||
* **xymon_cli__plug_kern_interval** : Time between each run of the `kern` plugin [default : `5m`].
|
||
|
||
#### Libs
|
||
|
||
Variables for the Libs plugin from hobbit-plugins. The plugin check for running
|
||
processes with upgraded libraries.
|
||
|
||
* **xymon_cli__plug_libs_state** : The state of plugin `libs` [default : `true`].
|
||
* **xymon_cli__plug_libs_package** : The packages to install to provide `libs` plugin [default : `[ 'lsof', 'sudo', 'libyaml-tiny-perl' ]`].
|
||
* **xymon_cli__plug_libs_path** : Configuration file for the `libs` plugin [default : `/etc/xymon/clientlaunch.d/libs.cfg`].
|
||
* **xymon_cli__plug_libs_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/libs.cfg.j2`].
|
||
* **xymon_cli__plug_libs_interval** : Time between each run of the `libs` plugin [default : `5m`].
|
||
* **xymon_cli__plug_libs_default_whitelist** : Default whitelist of processes that should not be monitored with `libs` plugin.
|
||
* **xymon_cli__plug_libs_whitelist** : All hosts whitelist of processes that should not be monitored with `libs` plugin.
|
||
* **xymon_cli__plug_libs_group_whitelist** : Group whitelist of processes that should not be monitored with `libs` plugin.
|
||
* **xymon_cli__plug_libs_host_whitelist** : Host whitelist of processes that should not be monitored with `libs` plugin.
|
||
|
||
#### Net
|
||
|
||
Require hobbit-plugins > 20200525.
|
||
|
||
Variables for the Megaraid plugin from hobbit-plugins. The plugin check
|
||
hardware raid status with Megacli tools [from hwraid.le-vert](url hwraid).
|
||
You will need to install `megaclisas-status` by your own to get this plugin
|
||
running correctly. Please take a look to the [Readme](megaraid plugin doc) of
|
||
the project for more informations.
|
||
|
||
* **xymon_cli__plug_megaraid_state** : The state of plugin `megaraid` [default : `false`].
|
||
* **xymon_cli__plug_megaraid_package** : The packages to install to provide `megaraid` plugin [default : `[ 'libipc-run-perl' ]`].
|
||
* **xymon_cli__plug_megaraid_path** : Configuration file for the `megaraid` plugin [default : `/etc/xymon/clientlaunch.d/megaraid.cfg`].
|
||
* **xymon_cli__plug_megaraid_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/megaraid.cfg.j2`].
|
||
* **xymon_cli__plug_megaraid_interval** : Time between each run of the `megaraid` plugin [default : `5m`].
|
||
|
||
#### Mq
|
||
|
||
Variables for the Mq plugin from hobbit-plugins. The plugin check Postfix's
|
||
mail queue.
|
||
|
||
* **xymon_cli__plug_mq_state** : The state of plugin `mq` [default : `true`].
|
||
* **xymon_cli__plug_mq_package** : The packages to install to provide `mq` plugin [default : `[ 'libtimedate-perl' ]`].
|
||
* **xymon_cli__plug_mq_path** : Configuration file for the `mq` plugin [default : `/etc/xymon/clientlaunch.d/mq.cfg`].
|
||
* **xymon_cli__plug_mq_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/mq.cfg.j2`].
|
||
* **xymon_cli__plug_mq_interval** : Time between each run of the `mq` plugin [default : `5m`].
|
||
|
||
#### Net
|
||
|
||
Require hobbit-plugins > 20190129.
|
||
|
||
Variables for the Net plugin from hobbit-plugins. The plugin check network
|
||
interface states. Check the [Readme](net plugin doc) of the project for more
|
||
informations.
|
||
|
||
* **xymon_cli__plug_net_state** : The state of plugin `net` [default : `false`].
|
||
* **xymon_cli__plug_net_package** : The packages to install to provide `net` plugin [default : `[ 'ethtool', 'iproute2', 'libfile-slurp-perl', 'libfile-which-perl', 'libipc-run-perl', 'libyaml-tiny-perl' ]`].
|
||
* **xymon_cli__plug_net_path** : Configuration file for the `net` plugin [default : `/etc/xymon/clientlaunch.d/net.cfg`].
|
||
* **xymon_cli__plug_net_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/net.cfg.j2`].
|
||
* **xymon_cli__plug_net_interval** : Time between each run of the `net` plugin [default : `5m`].
|
||
* **xymon_cli__plug_net_conf_path**: Configuration file for the `net` script (probe silently exit if not present) [default : `/etc/xymon/net.yaml`].
|
||
* **xymon_cli__plug_net_conf_tpl**: Template used to generate the previous config file [default : `etc/xymon/net.yaml.j2`].
|
||
|
||
You really should consider writing your own template for `net` script,
|
||
specific to your host(s) network configuration and override
|
||
**xymon_cli__plug_net_conf_tpl** variable.
|
||
|
||
#### Netstats
|
||
|
||
Variables for the Netstats plugin from hobbit-plugins. The plugin check
|
||
network interface states.
|
||
|
||
* **xymon_cli__plug_netstats_state** : The state of plugin `netstats` [default : `false`].
|
||
* **xymon_cli__plug_netstats_path** : Configuration file for the `netstats` plugin [default : `/etc/xymon/clientlaunch.d/netstats.cfg`].
|
||
* **xymon_cli__plug_netstats_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/netstats.cfg.j2`].
|
||
* **xymon_cli__plug_netstats_interval** : Time between each run of the `netstats` plugin [default : `5m`].
|
||
|
||
#### Ntpq
|
||
|
||
Variables for the Ntpq plugin from hobbit-plugins. The plugin check
|
||
the ntpd daemon synchronization status (needs manual ntp installation).
|
||
|
||
* **xymon_cli__plug_ntpq_state** : The state of plugin `ntpq` [default : `false`].
|
||
* **xymon_cli__plug_ntpq_path** : Configuration file for the `ntpq` plugin [default : `/etc/xymon/clientlaunch.d/ntpq.cfg`].
|
||
* **xymon_cli__plug_ntpq_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/ntpq.cfg.j2`].
|
||
* **xymon_cli__plug_ntpq_interval** : Time between each run of the `ntpq` plugin [default : `5m`].
|
||
|
||
#### SGE
|
||
|
||
Variables for sge plugin from [ipr-cnrs.scripts][sge plugin source].
|
||
The plugin check health status for SGE queues and display informations about
|
||
SGE jobs and host.
|
||
|
||
* **xymon_cli__plug_sge_state** : The state of plugin `sge` [default : `False`].
|
||
* **xymon_cli__plug_sge_script_path** : Path to the `sge` script [default : `'/usr/lib/xymon/client/ext/sge'`].
|
||
* **xymon_cli__plug_sge_script_tpl** : Template used to generate the previous script [default : `'usr/lib/xymon/client/ext/sge.j2'`].
|
||
* **xymon_cli__plug_sge_script_url** : Use a remote file to get the previous script instead of a template [default : `''`].
|
||
* **xymon_cli__plug_sge_path** : Configuration file for the `sge` plugin [default : `'/etc/xymon/clientlaunch.d/sge.cfg'`].
|
||
* **xymon_cli__plug_sge_tpl** : Template used to generate the previous config file [default : `'etc/xymon/clientlaunch.d/sge.cfg.j2'`].
|
||
* **xymon_cli__plug_sge_interval** : Time between each run of the `sge` plugin [default : `'10m'`]
|
||
|
||
#### Smartoverall
|
||
|
||
Variables for Smartoverall plugin from [ipr-cnrs.scripts][smartoverall plugin source].
|
||
The plugin will try to display health status of each disks (with SMART support)
|
||
but it can't check that a recent test was successfully done.
|
||
This plugin is mostly useful for disks unknown from smartmontools's database.
|
||
For more features, see the next Smart plugin.
|
||
|
||
* **xymon_cli__plug_smartoverall_state** : The state of plugin `smartoverall` [default : `False`].
|
||
* **xymon_cli__plug_smartoverall_package** : The packages to install to provide `smartoverall` plugin [default : `[ 'smartmontools' ]`].
|
||
* **xymon_cli__plug_smartoverall_script_path** : Path to the `smartoverall` script [default : `'/usr/lib/xymon/client/ext/smartoverall'`].
|
||
* **xymon_cli__plug_smartoverall_script_tpl** : Template used to generate the previous script [default : `'usr/lib/xymon/client/ext/smartoverall.j2'`].
|
||
* **xymon_cli__plug_smartoverall_script_url** : Use a remote file to get the previous script instead of a template [default : `''`].
|
||
* **xymon_cli__plug_smartoverall_path** : Configuration file for the `smartoverall` plugin [default : `'/etc/xymon/clientlaunch.d/smartoverall.cfg'`].
|
||
* **xymon_cli__plug_smartoverall_tpl** : Template used to generate the previous config file [default : `'etc/xymon/clientlaunch.d/smartoverall.cfg.j2'`].
|
||
* **xymon_cli__plug_smartoverall_interval** : Time between each run of the `smartoverall` plugin [default : `'10m'`]
|
||
|
||
#### Smart
|
||
|
||
Variables for Smart plugin from [skazi0 xymon-plugins][smart plugin source].
|
||
The plugin check health status for each disks, compare current values with the
|
||
one's recommended by the vendor and check a recent (<24h) test was done.
|
||
|
||
* **xymon_cli__plug_smart_state** : The state of plugin `smart` [default : `False`].
|
||
* **xymon_cli__plug_smart_package** : The packages to install to provide `smart` plugin [default : `[ 'smartmontools' ]`].
|
||
* **xymon_cli__plug_smart_script_path** : Path to the `smart` script [default : `'/usr/lib/xymon/client/ext/smart'`].
|
||
* **xymon_cli__plug_smart_script_tpl** : Template used to generate the previous script [default : `'usr/lib/xymon/client/ext/smart.j2'`].
|
||
* **xymon_cli__plug_smart_script_url** : Use a remote file to get the previous script instead of a template [default : `''`].
|
||
* **xymon_cli__plug_smart_path** : Configuration file for the `smart` plugin [default : `'/etc/xymon/clientlaunch.d/smart.cfg'`].
|
||
* **xymon_cli__plug_smart_tpl** : Template used to generate the previous config file [default : `'etc/xymon/clientlaunch.d/smart.cfg.j2'`].
|
||
* **xymon_cli__plug_smart_interval** : Time between each run of the `smart` plugin [default : `'10m'`]
|
||
|
||
#### Temp
|
||
|
||
Variables for the temp plugin from hobbit-plugins. Simple temperature monitor.
|
||
|
||
* **xymon_cli__plug_temp_state** : The state of plugin `temp` [default : `False`].
|
||
* **xymon_cli__plug_temp_package** : The packages to install to provide `temp` plugin [default : `[ 'libfile-which-perl', 'libyaml-tiny-perl', 'smartmontools', 'libxml-twig-perl' ]`].
|
||
* **xymon_cli__plug_temp_path** : Configuration file for the `temp` plugin [default : `'/etc/xymon/clientlaunch.d/temp.cfg'`].
|
||
* **xymon_cli__plug_temp_tpl** : Template used to generate the previous config file [default : `'etc/xymon/clientlaunch.d/temp.cfg.j2'`].
|
||
* **xymon_cli__plug_temp_interval** : Time between each run of the `temp` plugin [default : `'5m'`]
|
||
|
||
##### Nvidia support
|
||
|
||
The temp plugin can also checks NVidia GPU temperature. In order to get those
|
||
informations, you need to install `nvidia-smi` package by your own or define
|
||
**xymon_cli__plug_temp_extra_package** var :
|
||
|
||
``` yml
|
||
xymon_cli__plug_temp_extra_package: [ 'nvidia-smi' ]
|
||
```
|
||
|
||
#### ZFS
|
||
|
||
Variables for ZFS plugin from [Xymonton][zfs plugin source]. The plugin check
|
||
health (global and for pools), capacity and snapshot status.
|
||
|
||
* **xymon_cli__plug_zfs_state** : The state of plugin `zfs` [default : `false`].
|
||
* **xymon_cli__plug_zfs_script_path** : Path to the ZFS script [default : `/usr/lib/xymon/client/ext/zfs`].
|
||
* **xymon_cli__plug_zfs_script_tpl** : Template used to generate the previous script [default : `usr/lib/xymon/client/ext/zfs.j2`].
|
||
* **xymon_cli__plug_zfs_path** : Configuration file for the `zfs` plugin [default : `/etc/xymon/clientlaunch.d/zfs.cfg`].
|
||
* **xymon_cli__plug_zfs_tpl** : Template used to generate the previous config file [default : `etc/xymon/clientlaunch.d/zfs.cfg.j2`].
|
||
* **xymon_cli__plug_zfs_interval** : Time between each run of the `zfs` plugin [default : `5m`].
|
||
|
||
#### Automatically enable some probes
|
||
|
||
It can be useful to automatically enable some probes according to the type of
|
||
servers :
|
||
* Enable temp probe on hardware hosts (also useful for Smartoverall and Smart):
|
||
|
||
``` yml
|
||
xymon_cli__plug_temp_state: '{{ True
|
||
if (ansible_virtualization_role == "host")
|
||
else False }}'
|
||
```
|
||
|
||
### OS Specific Variables
|
||
|
||
Please see default value by Operating System file in [vars][vars directory] directory.
|
||
|
||
* **xymon_cli__pkg_list** : The list of packages to install to provide `xymon-client`.
|
||
* **xymon_cli__plug_pkg_list** : The list of packages to install to provide extra plugins to Xymon client.
|
||
|
||
## Example Playbook
|
||
|
||
* Use defaults vars :
|
||
|
||
``` yml
|
||
- hosts: serverXYZ
|
||
roles:
|
||
- role: ipr-cnrs.xymon
|
||
```
|
||
|
||
## Configuration
|
||
|
||
This role will :
|
||
* Install needed packages to provide `xymon-client`.
|
||
* Manage `xymon-client` configuration and service.
|
||
* Add 'xymon' user to new groups.
|
||
|
||
## Plugins
|
||
|
||
Some plugins and options can be managed with this role :
|
||
* apt : Check state of packages and repositories.
|
||
* kern : Check for outdated running kernel and need for reboot.
|
||
* libs : Check for running processes with upgraded libraries.
|
||
* mq : Check mail queue.
|
||
* zfs : Check ZFS pools status.
|
||
|
||
## Development
|
||
|
||
This source code comes from our [Gogs instance][xymon source] and the [Github repo][xymon github] exist just to be able to send the role to Ansible Galaxy…
|
||
|
||
But feel free to send issue/PR here :)
|
||
|
||
Thanks to this [hook][gogs to github hook], Github automatically got updates from our [Gogs instance][xymon source] :)
|
||
|
||
## License
|
||
|
||
[WTFPL][wtfpl website]
|
||
|
||
## Author Information
|
||
|
||
Jérémy Gardais
|
||
* Source : [on IPR's Gogs][xymon source]
|
||
* [IPR][ipr website] (Institut de Physique de Rennes)
|
||
|
||
[vars directory]: ./vars
|
||
[gogs to github hook]: https://stackoverflow.com/a/21998477
|
||
[xymon source]: https://git.ipr.univ-rennes.fr/cellinfo/ansible.xymon
|
||
[xymon github]: https://github.com/ipr-cnrs/xymon
|
||
[wtfpl website]: http://www.wtfpl.net/about/
|
||
[ipr website]: https://ipr.univ-rennes1.fr/
|
||
|
||
[url hwraid]: https://hwraid.le-vert.net/wiki/DebianPackages
|
||
[megaraid plugin doc]: https://salsa.debian.org/debian/hobbit-plugins#megaraid-check-state-of-lsi-megaraid-sas-controllers
|
||
[net plugin doc]: https://salsa.debian.org/debian/hobbit-plugins#net-check-network-interface-states
|
||
[sge plugin source]: https://git.ipr.univ-rennes.fr/cellinfo/scripts/src/master/xymon/plugins/client/ext/sge.sh
|
||
[smartoverall plugin source]: https://git.ipr.univ-rennes.fr/cellinfo/scripts/src/master/xymon/plugins/client/ext/smartoverall
|
||
[smart plugin source]: https://github.com/skazi0/xymon-plugins
|
||
[zfs plugin source]: https://wiki.xymonton.org/doku.php/monitors:bb-zfs
|