# Plugin Linode

# Introducción

<span style="font-weight: 400;">**Ver**. 120521</span>

<span style="font-weight: 400;">Este plug-in sirve para monitorizar instancias en Linode. </span>

<span style="font-weight: 400;">Se conecta al servicio cloud de Linode para conseguir datos sobre las instancias que están en funcionamiento y envía estos datos al servidor de Pandora FMS desde el que se ha ejecutado.</span>

<span style="font-weight: 400;">**Tipo**: Plug-in de servidor </span>

# Matriz de compatibilidad

<table id="bkmrk-sistemas-donde-se-ha" style="color: #444444; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; height: 68px;"><tbody><tr style="height: 34px;"><td style="height: 34px; width: 233.6px;">**Sistemas donde se ha probado**

</td><td style="height: 34px; width: 528px;"><span style="font-weight: 400;">CentOS 7</span>

</td></tr><tr style="height: 34px;"><td style="height: 34px; width: 233.6px;">**Sistemas donde debería funcionar**

</td><td style="height: 34px; width: 528px;"><span style="font-weight: 400;">Cualquier sistema operativo Linux que tenga un servidor de Pandora FMS instalado</span>

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

# Pre requisitos

<span style="font-weight: 400;">Para poder ejecutar este plug-in se necesita: </span>

- <span style="font-weight: 400;">Tener el </span>**Data Server**<span style="font-weight: 400;"> de Pandora FMS habilitado</span>
- <span style="font-weight: 400;">Tener el </span>**Plugin Server**<span style="font-weight: 400;"> de Pandora FMS habilitado</span>
- <span style="font-weight: 400;">Cuenta creada en Linode </span>
- <span style="font-weight: 400;">Token de lectura de la API de Linode</span>

# Configuración

<span style="font-weight: 400;">Tanto el </span>**Data Server** <span style="font-weight: 400;">como el </span>**Plugin Server**<span style="font-weight: 400;"> vienen por defecto habilitados en Pandora FMS. No obstante, si quisiéramos comprobar que tenemos ambos servidores habilitados, o no estamos seguros, accedemos al fichero de configuración del servidor de Pandora FMS, ubicado en /etc/pandora/pandora\_server.conf.</span>

<span id="bkmrk--1">![](https://lh3.googleusercontent.com/v3Xj1aINq4t-G8kbcRC-A5Cae0IV-42hldP26JAK0_wguQcQRAo3bWRfOsHhaf8MtZ82-DVFnTUA7NSWS8tsRRpYkeH5I62jE4wnGKhqTK3kgH2JYw9s18lZuDsnu7SCAr2v9N1d)</span>

<span id="bkmrk--2">![](https://lh6.googleusercontent.com/zPyYJILD3-BeDXJCYP7gBBGVKb_-mZehLVvDe7nctb3YMwh7Jljr2mPgxBo5lb0sZszWpAiyQppVqcc25caeo_8J5yjhFOpdSG71MM2kYMDvioqw9O7vCsXxB8PwcZPqOx-6oiBw)</span>

<span id="bkmrk-una-vez-hayamos-camb-0">Una vez hayamos cambiado los parámetros deberemos reiniciar el servidor de Pandora FMS.  
</span>

```
/etc/init.d/pandora_server restart
```

# Parámetros generales del plugin

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

<span style="font-weight: 400;">Si la ejecución ha sido correcta deberíamos ver un ‘1’ al ejecutar el plugin. </span>

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

# Parámetros específicos del plugin

<span style="font-weight: 400;">Este plug-in cuenta con estos cuatro 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 la 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;">. Se utiliza para introducir el token para conectarse al servicio de Linode</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>

# Configuración en Pandora

<span style="font-weight: 400;">Lo ideal para ejecutar cualquier plug-in de servidor es que tengamos dicho plug-in ubicado en la siguiente ruta /usr/share/pandora\_server/util/plugin/</span>

<span id="bkmrk--11">![](https://lh4.googleusercontent.com/VuZ8eeIh0DhpItogtX5OvoWXC-m9tFWJAOyC9cOOvCTcXo9P-XfFxBakFJ_rHuNMAbe-5dt2HEeWlPA23yshjjH9-k8QofJxYzYlEuMWxZkCXDqQ_fgou5mrRegjyy3_jA-O5EO3)</span>

Una vez hecho esto, debemos cambiar el propietario y los permisos del plug-in para que puedan ser ejecutados por el servidor. Para ello usamos los siguientes comandos:

```
chown pandora:root pandora_linode
chmod 755 pandora_linode
```

<span id="bkmrk--12">![](https://lh6.googleusercontent.com/fM5bgM4nO4lyUAwmJkE2nzt6cAuM98ElNlXxiIuimWoNHuR5pU7_awaF1S08B6-Hm7nLkeA_vPdakwZ0WF7rtWx1nUH4Jy_jnC8UZLUgANLr2WQX_8OPP8wXyWv4ppZM_RoBEg9W)</span>

Deberá quedar así.

<span id="bkmrk--13">![](https://lh6.googleusercontent.com/RlyWAzpH9iLZYV3uOxh6A5hlhfBn2Sd_any4utbJVfASomxZX71DgquurVr2p8VQbrRqAIoSQb8Ak3Vt4UljYPrPx6ZhNTZYhlqOD--dloRygtuimrwNVS1kACaE97MxtGpyWgjC)</span>

A continuación procederemos a registrar el plug-in. En este caso realizaremos el registro manualmente.

El primer paso será acceder a la consola. En el apartado Servidores accedemos a la pestaña Plugins.

<span id="bkmrk--14">![](https://lh4.googleusercontent.com/ZLwxESev5gA-M8rsx77RQVuJlDGvTfZrEarE5JMJEf_CirYgel7Q2Ifk1ntExG9MSgN5GxbEz2CxhZa-iw--rRL2xEW6rT5k9Q063SkynrdtrEnjzsTjXWSwbw1OmVurFOmxdkSi)</span>

En esta pestaña aparecerán todos los plug-ins de servidor que vienen por defecto instalados con Pandora FMS.

Hacemos clic en Añadir.

<span id="bkmrk--15">![](https://lh6.googleusercontent.com/qsA_T3Zyae6qzjHvmih54i6UiVLGVqSDuMl7_XBCTfNQ7wb8iMm6O-MQYpVuyjB6o9KU54qlt0bYY7ZNFdZ2PQPXMSo1UAiu6H9bI_4ehOb_7TXxRzGn2Yy_Rwpx_6IUHa76AZwf)</span>

La siguiente ventana nos servirá para configurar el plug-in antes de registrarlo.

El primer apartado son opciones generales, donde podremos establecer el nombre que queremos proporcionar al plug-in, el tipo de plug-in, estándar o Nagios, el tiempo máximo de ejecución del plug-in y una breve descripción.

<span id="bkmrk--16">![](https://lh5.googleusercontent.com/Ut2FJMHz_gR46lR5DGHjfGxAyHkYTreKWNGTGzIO0S2-GInpwEQ3zdQpLqrMNTLfSSV2chJRbOyt3413a0sjNUQov-PGf2Bge8RJ1NZuE9m8UMuRZhERpXoYGRUy9pjUJkATZBuz)</span>

En el siguiente apartado definimos la ruta en la que está ubicado el plug-in y una serie de macros, que equivalen a los parámetros de los que está compuesto el plug-in.

<span id="bkmrk--17">![](https://lh6.googleusercontent.com/RE15rC1PxkhwVsxEXRGE4NIVbKYzKvfO8a1taN-1J5f522mzUhloTXBSc1wHhh_F7h0K8BBtrxYjNnZ9qx02YQ0xrtdeJGDVi45QZEzuKHY6RydzW6FTPs-4OUja3kTLi0fL4KJZ)</span>

Por último, si hemos añadido parámetros de ejecución, este apartado nos servirá para definir esos parámetros mediante macros. También podemos añadir valores por defecto a dichas macros, para que se utilicen en caso de no proporcionar un parámetro.

En este caso, dado que el único parámetro obligatorio es el de token, los otros dos estarán configurados con los valores por defecto.

<span id="bkmrk--18">![](https://lh6.googleusercontent.com/ZH-HjIAk2NzE-Sy0qvlZFu2gnb-Ba9g4ah313GQjzUEnStxo_Ck2y5TOZuoVF0DeBBXYriO_57h7UWuXgnhCupnk4_KcoKn6YByswzBWA8TUoEMkDxrYpmWyS7BhJT_ozEbG0ne_)</span>

Una vez hayamos terminado, hacemos clic en Crear.

A continuación vamos a crear un módulo de tipo plug-in de servidor.

Para ello nos dirigimos a Recursos &gt; Administrar agentes y hacemos clic en 'Modulos'.

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

Elegimos tipo 'Plugin server module' y hacemos clic en Crear.

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

En el apartado de configuración del plug-in podemos rellenar varios campos. Seleccionamos el plug-in y añadimos el token. Como los campos grupo y directorio de datos los hemos definido por defecto no será necesario modificarlos.

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

Una vez finalizado hacemos clic en Crear.

Si lo hemos configurado bien, el resultado será el siguiente:

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

# Módulos generados por el plugin

Como hemos dicho antes, para saber si el plug-in ha funcionado, el módulo nos debe devolver un 1.

<span id="bkmrk--3">![](https://lh3.googleusercontent.com/M0-Xay7uyoBytBEXNDPPQImNQBKB1zSoYjXisKbYteifspGP8v99pJRyLKkdg7RrTAiNojInZs826oL95ee_KTd51bVQAV9zO_MGk-wy2StSdt9-fAlpapLxX3pKsH7Nl5WNQeWq)</span>

En este caso, el plug-in crea varios agentes uno por cada instancia en linode, cada uno provisto de sus módulos correspondientes.

<span id="bkmrk--4">![](https://lh5.googleusercontent.com/tEvY8-aYbUdXy4WpKYicYDUKoXAt7LHKa5N98gNVBJGAqwIpXZjbWp4w3e-B5qZHlrXI-KSPyRZpQM2THOLZnAd4aRJ9Su9GpDq7uHexfHoX3er6UpBJ1QhgqixyrcbMdcg-BMJ-)</span>

Ejemplo de listado de módulos dentro del agente ‘Linode centos-eu-west’

<span id="bkmrk--5">![](https://lh5.googleusercontent.com/2aAVronm2GaOWrbzYYMT8VVhbF2mF_gM-UHP0t_lOouPKWfc3Yqw3YD6J88JG9qA1WooPEi_QXMSqg7XG63KAtoLabS3yjdYSqMz9dwBuMunZJQ90A2KOL12WLLtoXH6BQxRSJpv)</span>

Tabla de módulos

<table border="1" id="bkmrk-nombre-del-m%C3%B3dulo-de" style="border-collapse: collapse; width: 100%; height: 354px;"><tbody><tr style="height: 29px;"><td style="width: 50%; height: 29px;">**Nombre del módulo**</td><td style="width: 50%; height: 29px;">**Descripción**</td></tr><tr style="height: 35px;"><td style="width: 50%; height: 35px;">CPU\_Load

</td><td style="width: 50%; height: 35px;">Porcentaje de CPU usada</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Input/Output statistics IO</td><td style="width: 50%; height: 29px;">Bloques escritos</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Last Update</td><td style="width: 50%; height: 29px;">Fecha de última actualización</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Linode Type</td><td style="width: 50%; height: 29px;">Tipo de instancia, tamaño, imagen..</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Linode\_Status</td><td style="width: 50%; height: 29px;">Estado de la instancia</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Region</td><td style="width: 50%; height: 29px;">Localización de la instancia</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Running\_Status</td><td style="width: 50%; height: 29px;">Funcionamiento de la instancia</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Traffic netv4 in</td><td style="width: 50%; height: 29px;">Estadísticas de entrada para IPv4 en bits/s</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Traffic netv4 out</td><td style="width: 50%; height: 29px;">Estadísticas de salida para IPv4 en bits/s</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Traffic netv4 private\_in</td><td style="width: 50%; height: 29px;">Estadísticas de entrada para red privada IPv4 en bits/s</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;">Traffic netv4 private\_out</td><td style="width: 50%; height: 29px;">Estadísticas de salida para red privada IPv4 en bits/s</td></tr></tbody></table>

<span id="bkmrk--6">![](https://lh4.googleusercontent.com/hwQYPWe288hlli9sqXNsMRZCKK0jP8jfG9gIS-MFtT8Xqx-4uvHLWh7zxKVljeY_JQZQR6ItfbKeMIXv2b9lOzx_Tjzj1vlprN0nBxULN0Io7_8uBS843xpWSl4EkUEOt1EeCTjw)</span>