OVH

Este documento describe la funcionalidad OVH del discovery de PandoraFMS.

Introducción

Este plugin tiene como finalidad monitorizar OVH, monitorizando el estado de las máquinas virtuales y estadísticas de estas como el cpu o la memoria.

El plugin se conecta al API de OVH y monitoriza máquinas virtuales, servers, o costes , generando un agente para cada elemento  vía XML que envía al servidor de pandora.

Matriz de compatibilidad

Sistemas donde se ha probado Rocky linux, Fedora 34
Sistemas donde funciona Cualquier sistema linux

Prerrequisitos

El plugin es un binario que contiene las dependencias empaquetadas por lo que no es necesaria la instalación de ningún tipo de dependencia para su uso.

Para conectar, hacen falta application key, application secret y consumer key, el proceso para obtenerlas esta documentado en la página de ovh, esta información esta disponible en el siguiente link:

https://help.ovhcloud.com/csm/es-es-api-getting-started-ovhcloud-api?id=kb_article_view&sysparm_article=KB0042785                                      

Parámetros y configuración

Parámetros

--conf Ruta al archivo de configuración

Archivo de configuración (--conf)

application_key = < Clave application key >
application_secret = < Clave application secret >
consumer_key = <  Clave consumer key >
interval         = < Intervalo en segundos para los agentes y para el analisis de métricas >
agent_group_name = < Nombre del grupo de destino para los agentes creados >
prefix           = < Prefijo para el nombre de los agentes >
transfer_mode    = < Modo de transferencia, tentacle o local >
data_dir         = < (Solo se activa si el transfer_mode es local) Ruta de destino para los XML de cada agente, por defecto "/var/spool/pandora/data_in/" >
tentacle_ip      = < IP de la máquina destino para los agentes creados >
tentacle_port    = < Puerto de tentacle, por defecto : 41121 >
cost             = < Activar con 1 para habilitar la monitorización de costes  >
scan_vms         = < Activar con 1 para habilitar la monitorización de máquinas virtuales >
storage          = < Activar con 1 para habilitar la monitorización de volúmenes  >
servers          = < Activar con 1 para habilitar la monitorización de servers  >
advance_monitoring  = < Activar con 1 para habilitar la monitorización avanzada >

Ejemplo

application_key = 6787fa7fa6f68687fafa
application_secret = faf7879afa87f9af9af78fa7f
consumer_key = 8fa8f8af8a8f78af5a3f2af

interval         = 300
agent_group_name = OVH
prefix           = ovh.
transfer_mode    = tentacle
data_dir         = /var/spool/pandora/data_in/
tentacle_ip      = 172.42.42.101
tentacle_port    = 41121 

cost                = 0
scan_vms            = 1
storage             = 1
servers             = 1
advance_monitoring  = 0

Habilitar la monitorización avanzada y los costos puede aumentar la duración de la ejecución del plugin, si no se habilita la monitorización avanzada, en las máquinas virtuales solo se monitorizará su status.

Ejecución manual

El formato de la ejecución del plugin es el siguiente:

./pandora_ovh --conf < ruta al fichero de configuración >

Por ejemplo:

./pandora_ovh --conf /usr/share/pandora_server/util/plugin/ovh-cloud.conf

La ejecución devolverá una salida en formato JSON con información sobre la ejecución, y generará un fichero XML para cada agente monitorizado que enviará al servidor de Pandora FMS por el método de transferencia indicado en la configuración.

Por ejemplo:

{"summary": {"Total agents": 17, "VMs agents": 12, "Storage agents": 1, "Server agents" : 3}}

Discovery

Este plugin puede integrarse con el Discovery de Pandora FMS.

Para ello se debe cargar el paquete ".disco" que puede descargar desde la librería de Pandora FMS:

https://pandorafms.com/library/

image.png

Una vez cargado, se podrán monitorizar entornos de OVH creando tareas de Discovery desde la sección Management > Discovery > Cloud

Para cada tarea se solicitarán los siguientes datos mínimos:

image.png

.También se podrá ajustar la configuración de la tarea para personalizar la monitorización deseada:

image.png

Las tareas completadas con éxito tendrán un resumen de ejecución con la siguiente información:

image.png

Agentes y módulos generados por el plugin

La ejecución del plugin, con todas las opciones activadas, creara los siguientes agentes y módulos:

< prefijo >.OVH 

Módulos

OVH VMs count
OVH total costs
OVH mont costs
< prefijo >. nombre máquina virtual

Módulos

< nombre máquina virtual >. status
< nombre máquina virtual >. cpu:used
< nombre máquina virtual >. cpu:max
< nombre máquina virtual >. mem:used
< nombre máquina virtual >. mem:max
< nombre máquina virtual >. net:rx
< nombre máquina virtual >. net:tx
< prefijo >. nombre volumen

Módulos

< nombre volumen >.status
< nombre volumen >.size
< nombre volumen >.type
< nombre volumen >.bootable
< nombre volumen >.region
< nombre volumen >.creationDate
< nombre volumen >.attachedTo
< prefijo >. nombre server

Módulos

< nombre servidor >.status
< nombre servidor >.powerState
< nombre servidor >.datacenter
< nombre servidor >.region
< nombre servidor >.linkSpeed
< nombre servidor >.availityZone
< nombre servidor >.os
< nombre servidor >.rack
< nombre servidor >.reverse
< nombre servidor >.supportLevel
< nombre servidor >.commercialRange