Plugin DigitalOcean
𝘗𝘭𝘶𝘨𝘪𝘯 para comprobar datos de las cuentas de DigitalOcean y sus "droplets" (máquinas virtuales).
- 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 :