Plugin DigitalOcean

• Introducción
• Matriz de compatibilidad
• Pre requisitos
• Configuración
• Parámetros generales del plugin
• Parametros específicos del plugin
• Ejecución manual
• Configuración en Pandora
• Modulos generados por el plugin

Introducción

Ver. 240521

Se conecta a la cuenta mediante un token.

Tipo: Plug-in de servidor

Matriz de compatibilidad

Sistemas donde se ha probado	CentOS 7
Sistemas donde debería funcionar	Cualquier sistema linux

Pre requisitos

Se requiere :

• Cuenta en digital Ocean
• Generar un token de lectura de la API desde digital ocean
• Tener el Data Server de Pandora FMS habilitado
• Tener el Plugin Server de Pandora FMS habilitado

 

 

Configuración

Habrá que generar un token, que sera la clave que accedera mediante la api a los datos de nuestra cuenta, esta se genera de la siguiente manera.

Vamos a api desde el menu de digital ocean:

Damos a generar nuevo token :

Le ponemos un nombre y los permisos que nos interesen y lo generamos:

 

Recuerda guardar bien el token porque solo saldrá una vez, si se extravía siempre se puede crear otro nuevo.

Parámetros generales del plugin

./pandora_digitalocean -t <token> [ -g <group> ] [ --data_dir <data_dir > ]

Si la ejecución ha sido correcta veremos un ‘1’ al ejecutar el plugin. 

 

Parametros específicos del plugin

El plug-in cuenta con los siguientes parámetros:

Parámetro	Descripción
-h, --help	Muestra un pequeño mensaje de ayuda
-t TOKEN, --token TOKEN	Es obligatorio. Para introcir el token que hemos generado en digital ocean
-g GROUP, --group GROUP	Grupo de destino de Pandora FMS
--data_dir DATA_DIR	Directorio de datos de Pandora FMS. Por defecto es /var/spool/pandora/data_in/

 

Ejemplo de ayuda:

Ejecución manual

Podemos comprobar el plugin desde el terminal para ver si funciona, para comprobarlo, ejecutamos el plugin:

Ejecución del plug-in en su versión para windows

Desde windows, podemos comprobarlo con el siguiente comando, llamando al .exe:

pandora_digitalocean.exe -t <token> --data_dir <direccion>

Configuración en Pandora

La mejor forma de manejar plugins de servidor en Pandora es desde "/usr/share/pandora_server/util/plugin" asi que lo enviaremos por pscp a esa ruta :

Si no nos deja ejecutarlo porque no tenemos permisos deberemos darselos con el siguiente comando :

chmod 755 pandora_digitalocean

Una vez hecho esto, vamos a proceder a instalarlo en la consola de Pandora :

Vamos a servidores > plugins:

Pinchamos en "añadir":

Le ponemos nombre y si queremos, descripción :

Metemos en comando del plugin la ruta en la que lo hemos ubicado anteriormente y en parametros lo que queramos sacar, como en este caso solo quiero generar los agentes y la direccion ya viene configurada solo metere _field1_  , si quisieramos meter otra direccion donde guardar los datos que genere el plugin, añadiriamos --data_dir _field2_ en parámetros del plugin. Le pondremos una descripción (token, por ejemplo) y en valor por defecto meteremos el token generado antes. Hecho esto se habrán creado dos agentes con sus respectivos módulos.

 

 

 

Modulos generados por el plugin

Se creara un agente que recogera datos de la cuenta y otro agente por cada droplet que tengamos :

En los agentes de los droplets, se mostrara información sobre estos, en el de la cuenta, tu balance, status, etc.

Digital Account droplets

Droplet_disk	Info de disk
Droplet_memory	Info de la memoria
Droplet_name	Nombre del droplet
Droplet_status	Para saber si el droplet esta activo
Droplet_vcpus	Información sobre vcpus

 

Ejemplo en consola :

 

Digital_Ocean_Account <email>

Account_balance	Balance de la cuenta en $
Digital_Ocean_Status	El status de la cuenta de digital ocean
Month_to_date_balance	Balance del mes hasta la fecha

Ejemplo en la consola de Pandora :