ipr-cnrs.xymon

Descripción general Versiones Perspectivas

Xymon

Descripción general
Variables del rol
- Variables específicas de plugins
- Variables específicas del sistema operativo
Ejemplo de Playbook
Configuración
Plugins
Desarrollo
Licencia
Información del autor

Descripción general

Gestionar la instalación y configuración del cliente Xymon.

Variables del rol

xymon_cli__manage: Si xymon-client debe ser gestionado con este rol [por defecto : true].
xymon_cli__pkg_state: Estado del nuevo paquete xymon-client [por defecto : present].
xymon_cli__default_conf_path: Archivo de configuración para xymon-client [por defecto : /etc/default/xymon-client].
xymon_cli__default_conf_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/default/xymon-client.j2].
xymon_cli__hostname: Permite sobreescribir el valor predeterminado de la variable CLIENTHOSTNAME [por defecto : {{ ansible_fqdn }}].
xymon_cli__user_groups: Lista de grupos del usuario 'xymon' [por defecto : xymon].
xymon_cli__service_manage: Si el servicio xymon-client debe ser gestionado con este rol [por defecto : true].
xymon_cli__service_name: Nombre del servicio xymon-client [por defecto : xymon-client].
xymon_cli__service_enabled: Configura el servicio xymon-client para que esté disponible al inicio [por defecto : true].
xymon_cli__srv_list: Lista de servidores Xymon (debe dar un nombre de host, IP,… accesible desde cualquier cliente) [por defecto : monitoring.{{ ansible_domain }}].
xymon_cli__plug_manage: Si este rol debe gestionar la configuración de los plugins [por defecto : true].

Variables específicas de plugins

xymon_cli__plug_combined_packages: Combina todas las variables de paquetes relacionadas con los plugins (solo plugins habilitados).
xymon_cli__plug_combined_clientlaunch: Combina archivos de clientlaunch para todos los plugins.

APT

Variables para el plugin APT de hobbit-plugins. El plugin verifica actualizaciones pendientes.

xymon_cli__plug_apt_state: El estado del plugin apt [por defecto : true].
xymon_cli__plug_apt_package: Los paquetes a instalar para proporcionar el plugin apt [por defecto : [ 'libtimedate-perl' ]].
xymon_cli__plug_apt_path: Archivo de configuración para el plugin apt [por defecto : /etc/xymon/clientlaunch.d/apt.cfg].
xymon_cli__plug_apt_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/apt.cfg.j2].
xymon_cli__plug_apt_interval: Tiempo entre cada ejecución del plugin apt [por defecto : 5m].
xymon_cli__plug_apt_default_whitelist: Lista predeterminada de paquetes permitidos no instalados desde repositorios [por defecto : []].
xymon_cli__plug_apt_whitelist: Lista de todos los hosts de paquetes permitidos no instalados desde repositorios [por defecto : []].
xymon_cli__plug_apt_group_whitelist: Lista de grupos de paquetes permitidos no instalados desde repositorios [por defecto : []].
xymon_cli__plug_apt_host_whitelist: Lista de hosts de paquetes permitidos no instalados desde repositorios [por defecto : []].

IPMI

Variables para el plugin IPMI de hobbit-plugins. El plugin lee sensores IPMI y el registro de eventos.

xymon_cli__plug_ipmi_state: El estado del plugin ipmi [por defecto : false].
xymon_cli__plug_ipmi_package: Los paquetes a instalar para proporcionar el plugin ipmi [por defecto : [ 'ipmitool' ]].
xymon_cli__plug_ipmi_path: Archivo de configuración para el plugin ipmi [por defecto : /etc/xymon/clientlaunch.d/ipmi.cfg].
xymon_cli__plug_ipmi_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/ipmi.cfg.j2].
xymon_cli__plug_ipmi_interval: Tiempo entre cada ejecución del plugin ipmi [por defecto : 5m].

Kern

Variables para el plugin kern de hobbit-plugins. El plugin verifica si hay kernels obsoletos en ejecución y la necesidad de reiniciar.

xymon_cli__plug_kern_state: El estado del plugin kern [por defecto : true].
xymon_cli__plug_kern_package: Los paquetes a instalar para proporcionar el plugin kern [por defecto : [ 'binutils', 'libfile-slurp-perl', 'libsort-naturally-perl' ]].
xymon_cli__plug_kern_path: Archivo de configuración para el plugin kern [por defecto : /etc/xymon/clientlaunch.d/kern.cfg].
xymon_cli__plug_kern_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/kern.cfg.j2].
xymon_cli__plug_kern_interval: Tiempo entre cada ejecución del plugin kern [por defecto : 5m].

Libs

Variables para el plugin Libs de hobbit-plugins. El plugin verifica procesos en ejecución con bibliotecas actualizadas.

xymon_cli__plug_libs_state: El estado del plugin libs [por defecto : true].
xymon_cli__plug_libs_package: Los paquetes a instalar para proporcionar el plugin libs [por defecto : [ 'lsof', 'sudo', 'libyaml-tiny-perl' ]].
xymon_cli__plug_libs_path: Archivo de configuración para el plugin libs [por defecto : /etc/xymon/clientlaunch.d/libs.cfg].
xymon_cli__plug_libs_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/libs.cfg.j2].
xymon_cli__plug_libs_interval: Tiempo entre cada ejecución del plugin libs [por defecto : 5m].
xymon_cli__plug_libs_default_whitelist: Lista predeterminada de procesos que no deben ser monitoreados con el plugin libs.
xymon_cli__plug_libs_whitelist: Lista de todos los hosts de procesos que no deben ser monitoreados con el plugin libs.
xymon_cli__plug_libs_group_whitelist: Lista de grupos de procesos que no deben ser monitoreados con el plugin libs.
xymon_cli__plug_libs_host_whitelist: Lista de hosts de procesos que no deben ser monitoreados con el plugin libs.

Net

Requiere hobbit-plugins > 20200525.

Variables para el plugin Megaraid de hobbit-plugins. El plugin verifica el estado del RAID de hardware con herramientas Megacli [de hwraid.le-vert](url hwraid). Necesitarás instalar megaclisas-status por tu cuenta para que este plugin funcione correctamente. Consulta el [Readme](documentación del plugin megaraid) del proyecto para más información.

xymon_cli__plug_megaraid_state: El estado del plugin megaraid [por defecto : false].
xymon_cli__plug_megaraid_package: Los paquetes a instalar para proporcionar el plugin megaraid [por defecto : [ 'libipc-run-perl' ]].
xymon_cli__plug_megaraid_path: Archivo de configuración para el plugin megaraid [por defecto : /etc/xymon/clientlaunch.d/megaraid.cfg].
xymon_cli__plug_megaraid_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/megaraid.cfg.j2].
xymon_cli__plug_megaraid_interval: Tiempo entre cada ejecución del plugin megaraid [por defecto : 5m].

Mq

Variables para el plugin Mq de hobbit-plugins. El plugin verifica la cola de correo de Postfix.

xymon_cli__plug_mq_state: El estado del plugin mq [por defecto : true].
xymon_cli__plug_mq_package: Los paquetes a instalar para proporcionar el plugin mq [por defecto : [ 'libtimedate-perl' ]].
xymon_cli__plug_mq_path: Archivo de configuración para el plugin mq [por defecto : /etc/xymon/clientlaunch.d/mq.cfg].
xymon_cli__plug_mq_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/mq.cfg.j2].
xymon_cli__plug_mq_interval: Tiempo entre cada ejecución del plugin mq [por defecto : 5m].

Net

Requiere hobbit-plugins > 20190129.

Variables para el plugin Net de hobbit-plugins. El plugin verifica el estado de las interfaces de red. Consulta el [Readme](documentación del plugin net) del proyecto para más información.

xymon_cli__plug_net_state: El estado del plugin net [por defecto : false].
xymon_cli__plug_net_package: Los paquetes a instalar para proporcionar el plugin net [por defecto : [ 'ethtool', 'iproute2', 'libfile-slurp-perl', 'libfile-which-perl', 'libipc-run-perl', 'libyaml-tiny-perl' ]].
xymon_cli__plug_net_path: Archivo de configuración para el plugin net [por defecto : /etc/xymon/clientlaunch.d/net.cfg].
xymon_cli__plug_net_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/net.cfg.j2].
xymon_cli__plug_net_interval: Tiempo entre cada ejecución del plugin net [por defecto : 5m].
xymon_cli__plug_net_conf_path: Archivo de configuración para el script net (provoca salida silenciosa si no está presente) [por defecto : /etc/xymon/net.yaml].
xymon_cli__plug_net_conf_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/net.yaml.j2].

Realmente deberías considerar escribir tu propia plantilla para el script net, específica para la configuración de red de tu(s) host(s), y sobreescribir la variable xymon_cli__plug_net_conf_tpl.

Netstats

Variables para el plugin Netstats de hobbit-plugins. El plugin verifica el estado de las interfaces de red.

xymon_cli__plug_netstats_state: El estado del plugin netstats [por defecto : false].
xymon_cli__plug_netstats_path: Archivo de configuración para el plugin netstats [por defecto : /etc/xymon/clientlaunch.d/netstats.cfg].
xymon_cli__plug_netstats_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/netstats.cfg.j2].
xymon_cli__plug_netstats_interval: Tiempo entre cada ejecución del plugin netstats [por defecto : 5m].

Ntpq

Variables para el plugin Ntpq de hobbit-plugins. El plugin verifica el estado de sincronización del daemon ntpd (necesita instalación manual de ntp).

xymon_cli__plug_ntpq_state: El estado del plugin ntpq [por defecto : false].
xymon_cli__plug_ntpq_path: Archivo de configuración para el plugin ntpq [por defecto : /etc/xymon/clientlaunch.d/ntpq.cfg].
xymon_cli__plug_ntpq_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/ntpq.cfg.j2].
xymon_cli__plug_ntpq_interval: Tiempo entre cada ejecución del plugin ntpq [por defecto : 5m].

SGE

Variables para el plugin sge de ipr-cnrs.scripts. El plugin verifica el estado de salud de las colas SGE y muestra información sobre trabajos y hosts SGE.

xymon_cli__plug_sge_state: El estado del plugin sge [por defecto : False].
xymon_cli__plug_sge_script_path: Ruta al script sge [por defecto : '/usr/lib/xymon/client/ext/sge'].
xymon_cli__plug_sge_script_tpl: Plantilla utilizada para generar el script anterior [por defecto : 'usr/lib/xymon/client/ext/sge.j2'].
xymon_cli__plug_sge_script_url: Usar un archivo remoto para obtener el script anterior en lugar de una plantilla [por defecto : ''].
xymon_cli__plug_sge_path: Archivo de configuración para el plugin sge [por defecto : '/etc/xymon/clientlaunch.d/sge.cfg'].
xymon_cli__plug_sge_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : 'etc/xymon/clientlaunch.d/sge.cfg.j2'].
xymon_cli__plug_sge_interval: Tiempo entre cada ejecución del plugin sge [por defecto : '10m']

Smartoverall

Variables para el plugin Smartoverall de ipr-cnrs.scripts. El plugin intentará mostrar el estado de salud de cada disco (con soporte SMART) pero no puede verificar que se haya realizado una prueba reciente con éxito. Este plugin es principalmente útil para discos desconocidos en la base de datos de smartmontools. Para más características, consulta el siguiente plugin Smart.

xymon_cli__plug_smartoverall_state: El estado del plugin smartoverall [por defecto : False].
xymon_cli__plug_smartoverall_package: Los paquetes a instalar para proporcionar el plugin smartoverall [por defecto : [ 'smartmontools' ]].
xymon_cli__plug_smartoverall_script_path: Ruta al script smartoverall [por defecto : '/usr/lib/xymon/client/ext/smartoverall'].
xymon_cli__plug_smartoverall_script_tpl: Plantilla utilizada para generar el script anterior [por defecto : 'usr/lib/xymon/client/ext/smartoverall.j2'].
xymon_cli__plug_smartoverall_script_url: Usar un archivo remoto para obtener el script anterior en lugar de una plantilla [por defecto : ''].
xymon_cli__plug_smartoverall_path: Archivo de configuración para el plugin smartoverall [por defecto : '/etc/xymon/clientlaunch.d/smartoverall.cfg'].
xymon_cli__plug_smartoverall_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : 'etc/xymon/clientlaunch.d/smartoverall.cfg.j2'].
xymon_cli__plug_smartoverall_interval: Tiempo entre cada ejecución del plugin smartoverall [por defecto : '10m']

Smart

Variables para el plugin Smart de skazi0 xymon-plugins. El plugin verifica el estado de salud de cada disco, compara valores actuales con los recomendados por el vendedor y verifica que se haya realizado una prueba reciente (<24h).

xymon_cli__plug_smart_state: El estado del plugin smart [por defecto : False].
xymon_cli__plug_smart_package: Los paquetes a instalar para proporcionar el plugin smart [por defecto : [ 'smartmontools' ]].
xymon_cli__plug_smart_script_path: Ruta al script smart [por defecto : '/usr/lib/xymon/client/ext/smart'].
xymon_cli__plug_smart_script_tpl: Plantilla utilizada para generar el script anterior [por defecto : 'usr/lib/xymon/client/ext/smart.j2'].
xymon_cli__plug_smart_script_url: Usar un archivo remoto para obtener el script anterior en lugar de una plantilla [por defecto : ''].
xymon_cli__plug_smart_path: Archivo de configuración para el plugin smart [por defecto : '/etc/xymon/clientlaunch.d/smart.cfg'].
xymon_cli__plug_smart_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : 'etc/xymon/clientlaunch.d/smart.cfg.j2'].
xymon_cli__plug_smart_interval: Tiempo entre cada ejecución del plugin smart [por defecto : '10m']

Temp

Variables para el plugin temp de hobbit-plugins. Monitor de temperatura simple.

xymon_cli__plug_temp_state: El estado del plugin temp [por defecto : False].
xymon_cli__plug_temp_package: Los paquetes a instalar para proporcionar el plugin temp [por defecto : [ 'libfile-which-perl', 'libyaml-tiny-perl', 'smartmontools', 'libxml-twig-perl' ]].
xymon_cli__plug_temp_path: Archivo de configuración para el plugin temp [por defecto : '/etc/xymon/clientlaunch.d/temp.cfg'].
xymon_cli__plug_temp_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : 'etc/xymon/clientlaunch.d/temp.cfg.j2'].
xymon_cli__plug_temp_interval: Tiempo entre cada ejecución del plugin temp [por defecto : '5m']

Soporte de Nvidia

El plugin de temperatura también puede verificar la temperatura de la GPU NVidia. Para obtener esta información, necesitas instalar el paquete nvidia-smi por tu cuenta o definir la variable xymon_cli__plug_temp_extra_package:

xymon_cli__plug_temp_extra_package: [ 'nvidia-smi' ]

ZFS

Variables para el plugin ZFS de Xymonton. El plugin verifica la salud (global y por grupos), la capacidad y el estado de las instantáneas.

xymon_cli__plug_zfs_state: El estado del plugin zfs [por defecto : false].
xymon_cli__plug_zfs_script_path: Ruta al script ZFS [por defecto : /usr/lib/xymon/client/ext/zfs].
xymon_cli__plug_zfs_script_tpl: Plantilla utilizada para generar el script anterior [por defecto : usr/lib/xymon/client/ext/zfs.j2].
xymon_cli__plug_zfs_path: Archivo de configuración para el plugin zfs [por defecto : /etc/xymon/clientlaunch.d/zfs.cfg].
xymon_cli__plug_zfs_tpl: Plantilla utilizada para generar el archivo de configuración anterior [por defecto : etc/xymon/clientlaunch.d/zfs.cfg.j2].
xymon_cli__plug_zfs_interval: Tiempo entre cada ejecución del plugin zfs [por defecto : 5m].

Habilitar automáticamente algunas sondas

Puede ser útil habilitar automáticamente algunas sondas según el tipo de servidores:

Habilitar la sonda de temperatura en hosts de hardware (también útil para Smartoverall y Smart):

xymon_cli__plug_temp_state: '{{ True
                                 if (ansible_virtualization_role == "host")
                                 else False }}'

Variables específicas del sistema operativo

Por favor, consulta el valor predeterminado por archivo del sistema operativo en el directorio vars.

xymon_cli__pkg_list: La lista de paquetes a instalar para proporcionar xymon-client.
xymon_cli__plug_pkg_list: La lista de paquetes a instalar para proporcionar plugins adicionales al cliente Xymon.

Ejemplo de Playbook

Usar variables por defecto:

- hosts: serverXYZ
  roles:
    - role: ipr-cnrs.xymon

Configuración

Este rol hará:

Instalar los paquetes necesarios para proporcionar xymon-client.
Gestionar la configuración y el servicio del xymon-client.
Agregar el usuario 'xymon' a nuevos grupos.

Plugins

Algunos plugins y opciones pueden ser gestionados con este rol:

apt: Verificar el estado de los paquetes y repositorios.
kern: Verificar si hay kernels obsoletos en ejecución y la necesidad de reiniciar.
libs: Verificar procesos en ejecución con bibliotecas actualizadas.
mq: Verificar la cola de correo.
zfs: Verificar el estado de los grupos ZFS.