# Plugin DigitalOcean

# Introducción

**Ver**. 240521

<div id="bkmrk-con-este-plug-in-pod"><div><svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg><div>Con este plug-in podremos ver los datos de tu cuenta de digital ocean y de tus droplets.</div></div></div>Se conecta a la cuenta mediante un token.

**Tipo**: Plug-in de servidor

# Matriz de compatibilidad

<table border="1" id="bkmrk-sistemas-donde-se-ha" style="border-collapse: collapse; width: 100%; height: 84px;"><tbody><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde se ha probado**</td><td style="width: 50%; height: 28px;">CentOS 7

</td></tr><tr style="height: 28px;"><td style="width: 50%; height: 28px;">**Sistemas donde debería funcionar**</td><td style="width: 50%; height: 28px;">Cualquier sistema linux

</td></tr></tbody></table>

# 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:

[![image-1621867261462.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621867261462.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621867261462.png)

Damos a generar nuevo token :

[![image-1621867312609.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621867312609.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621867312609.png)

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

[![image-1621867353645.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621867353645.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622016138738.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1622016138738.png)

# Parametros específicos del plugin

<span style="font-weight: 400;">El plug-in cuenta con los siguientes parámetros:</span>

<table id="bkmrk-par%C3%A1metro-descripci%C3%B3"><tbody><tr><td>**Parámetro**

</td><td><span style="font-weight: 400;">Descripción</span>

</td></tr><tr><td><span style="font-weight: 400;">-h, --help</span>

</td><td><span style="font-weight: 400;">Muestra un pequeño mensaje de ayuda</span>

</td></tr><tr><td><span style="font-weight: 400;">-t TOKEN, --token TOKEN</span>

</td><td><span style="font-weight: 400;">Es </span>**obligatorio**<span style="font-weight: 400;">. Para introcir el token que hemos generado en digital ocean</span>

</td></tr><tr><td><span style="font-weight: 400;">-g GROUP, --group GROUP</span>

</td><td><span style="font-weight: 400;">Grupo de destino de Pandora FMS</span>

</td></tr><tr><td><span style="font-weight: 400;">--data\_dir DATA\_DIR</span>

</td><td><span style="font-weight: 400;">Directorio de datos de Pandora FMS. </span>**Por defecto**<span style="font-weight: 400;"> es /var/spool/pandora/data\_in/</span>

</td></tr></tbody></table>

Ejemplo de ayuda:

[![image-1621868162380.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621868162380.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622017233854.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622017302721.JPG)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622016023668.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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 &gt; plugins:

[![image-1621869065170.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621869065170.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621869065170.png)

Pinchamos en "añadir":

[![image-1621869099132.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621869099132.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621869099132.png)

Le ponemos nombre y si queremos, descripción :

[![image-1621869138494.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621869138494.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622015045457.JPG)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1622447536036.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/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**

<table border="1" id="bkmrk-droplet_disk-info-de" style="border-collapse: collapse; width: 100%; height: 145px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Droplet\_disk</td><td style="width: 50%; height: 29px;">Info de disk</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Droplet\_memory</td><td style="width: 50%; height: 29px;">Info de la memoria</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Droplet\_name</td><td style="width: 50%; height: 29px;">Nombre del droplet</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Droplet\_status</td><td style="width: 50%; height: 29px;">Para saber si el droplet esta activo</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Droplet\_vcpus</td><td style="width: 50%; height: 29px;">Información sobre vcpus</td></tr></tbody></table>

Ejemplo en consola :

[![image-1621869930146.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621869930146.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621869930146.png)

**Digital\_Ocean\_Account &lt;email&gt;**

<table border="1" id="bkmrk-account_balance-bala" style="border-collapse: collapse; width: 100%; height: 87px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Account\_balance</td><td style="width: 50%; height: 29px;">Balance de la cuenta en $</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Digital\_Ocean\_Status</td><td style="width: 50%; height: 29px;">El status de la cuenta de digital ocean</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Month\_to\_date\_balance</td><td style="width: 50%; height: 29px;">Balance del mes hasta la fecha</td></tr></tbody></table>

Ejemplo en la consola de Pandora :

[![image-1621870180347.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/scaled-1680-/image-1621870180347.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-05/image-1621870180347.png)