# OVH
# 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
- Conectividad a la API de OVH
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](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/](https://pandorafms.com/library/)
[](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/d6Rimage.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:
- **OVH application key :** .Clave application key.
- **OVH application secret :** Clave application secret.
- **OVH consumer key:** Clave consumer key.
- **Tentacle IP**: IP del servidor de Tentacle al que enviar los datos de los agentes. Normalmente este parámetro no se modificará.
- **Tentacle port**: Puerto del servidor de Tentacle al que enviar los datos. Normalmente este parámetro no se modificará.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/ty4image.png)
.También se podrá ajustar la configuración de la tarea para personalizar la monitorización deseada:
- **Scan Volumes :** Si se activa monitorizará los volúmenes y creará un agente por cada uno de estos.
- **Scan Servers:** Si se activa monitorizarál los servers y creará un agente por cada uno de estos.
- **Get monthly and overall costs:** Si se activa monitorizará los costes y creará un módulo de costos totales y otro de costos mensuales del último mes.
- **Monitor virtual machines:** Si se activa monitorizará las máquinas virtuales y creará un agente por cada una de estas.
- **Advanced statistics:** Si se activa habilitará módulos de estadísticas adicionales en los agentes de máquinas virtuales.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/dGSimage.png)
Las tareas completadas con éxito tendrán un resumen de ejecución con la siguiente información:
- **Total agents** : Número total de agentes generados por la tarea.
- **Storage agents :** Número total de agentes de proyectos creados por la tarea.
- **VMs agents :** Número total de agentes de máquinas virtuales creados por la tarea.
- **Server agents:** Número total de agentes de servidores creados por la tarea.
[](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/waHimage.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:
- **Agente global**