ansible.xymon/README.md

18 KiB
Raw Permalink Blame History

Xymon

  1. Overview
  2. Role Variables
  3. Example Playbook
  4. Configuration
  5. Plugins
  6. Development
  7. License
  8. 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. 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. 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. 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:

xymon_cli__plug_temp_extra_package: [ 'nvidia-smi' ]

ZFS

Variables for ZFS plugin from Xymonton. 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):
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 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:
- 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 and the Github repo exist just to be able to send the role to Ansible Galaxy…

But feel free to send issue/PR here :)

Thanks to this hook, Github automatically got updates from our Gogs instance :)

License

WTFPL

Author Information

Jérémy Gardais