Plugin DigitalOcean

𝘗𝘭𝘶𝘨𝘪𝘯 para comprobar datos de las cuentas de DigitalOcean y sus "droplets" (máquinas virtuales).

Introducción

Ver. 240521

Con este plug-in podremos ver los datos de tu cuenta de digital ocean y de tus droplets.

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 :

 

 

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:

image-1621867261462.png

Damos a generar nuevo token :

image-1621867312609.png

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

image-1621867353645.png

 

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. 

image-1622016138738.png

 

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:

image-1621868162380.png

Ejecución manual

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

image-1622017233854.png

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>

image-1622017302721.JPG

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 :

image-1622016023668.png

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:

image-1621869065170.png

Pinchamos en "añadir":

image-1621869099132.png

Le ponemos nombre y si queremos, descripción :

image-1621869138494.png

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.

 

image-1622015045457.JPG

 

 

Modulos generados por el plugin

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

image-1622447536036.png

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 :

image-1621869930146.png

 

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 :

image-1621870180347.png