# [Under Construction]Plugin Oracle Cloud

# Introducción

**Ver**. 260521

Este plug-in sirve para monitorizar instancias en Oracle Cloud. Utiliza el CLI de Oracle (OCI) y el ID del compartimento para obtener tanto el nombre de la máquina, como los datos de monitorización.

**Tipo**: plug-in de servidor

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

<span style="font-weight: 400;">Ubuntu 18.04.5</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 Oracle Cloud  
    </span>
- <span style="font-weight: 400;">Tener configurado el [CLI de Oracle](https://docs.oracle.com/es-ww/iaas/Content/API/SDKDocs/cliinstall.htm) correctamente en nuestro sistema </span>
- <span style="font-weight: 400;">ID del compartimento a monitorizar  
    </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>

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

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

<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
```

A continuación, deberemos comprobar que tenemos OCI correctamente configurado, para ello ejecutamos el siguiente comando:

```
oci os ns get
```

Y nos debería aparecer algo parecido a la siguiente imagen:

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

De no ser así, por favor consulte la documentación oficial de [Oracle](https://docs.oracle.com/es-ww/iaas/Content/API/SDKDocs/clitoken.htm).

# Parámetros generales del plugin

```
perl oracle_cloud.pl <compartment_id>
```

<div id="bkmrk-si-la-ejecuci%C3%B3n-es-c"><div><div>Si la ejecución es correcta, deberíamos ver un 1 al ejecutar el plug-in.<span style="color: #ce9178;">  
</span></div><div></div></div></div>[![image-1625658661131.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/scaled-1680-/image-1625658661131.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625658661131.png)

# Parámetros específicos del plugin

Este plug-in no cuenta con parámetros específicos por el momento.

# Configuración en Pandora

Para la ejecución de plug-ins de servidor, recomendamos su almacenamiento en el directorio /usr/share/pandora\_server/utils/plugin/

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

Una vez hayamos elegido la carpeta de destino, deberemos cambiar el propietario y los permisos del plug-in para evitar posibles problemas en la ejecución del mismo por el servidor de Pandora. Para ello utilizaremos los siguientes comandos:

```
chown pandora:root oracle_cloud.pl
chmod 755 oracle_cloud.pl
```

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

El resultado debe ser el siguiente:

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

El siguiente paso será registrar el plug-in mediante la consola web de Pandora.

Para ello accedemos a nuestra consola y seleccionamos en el panel lateral 'Servidores' y posteriormente 'Plugins'.

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

En esta ventana aparecerán todos los plug-ins registrados y listos para utilizarse en monitorizaciones de distintas clases.

Hacemos clic en 'Añadir'.

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

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.

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

En el siguiente apartado definimos la ruta en la que está ubicado el plug-in, y en este caso, una macro que equivaldrá al ID del compartimento a monitorizar.

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

Para finalizar, añadiremos un nombre descriptivo al campo \_field1\_ para que sea reconocible a la hora de crear el plug-in de servidor.

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

Una vez hecho esto, haremos clic en 'Crear'.

A continuación, procederemos a crear el plug-in de servidor en nuestro agente de Pandora.

En el menú, elegimos 'Recursos' y 'Administrar agentes'.

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

Pasamos el ratón por encima de nuestro agente y hacemos clic en 'Módulos'.

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

En la parte superior de la pantalla aparece la opción para crear nuevos módulos. En el desplegable 'Tipo' elegimos 'plug-in de servidor'.

Se nos abrirá una ventana para configurar el módulo.

Aquí podremos darle un nombre, elegir el tipo de dato que vamos a recicibir, en este caso al ser un plug-in de servidor recibiremos un 1, así que podremos dejarlo en *generic numeric,* y debemos seleccionar el plugin en el desplegable plugin. Cuando lo hayamos seleccionado aparecerá el campo donde podremos escribir nuestro ID de compartimento que vamos a monitorizar.

Por último, hacemos clic en 'Crear', y habremos finalizado.

[![image-1625662092896.png](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/scaled-1680-/image-1625662092896.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2021-07/image-1625662092896.png)Si lo hemos configurado correctamente, el resultado debería ser así:

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

# Módulos generados por el plugin

La ejecución de este plug-in conlleva la creación de un agente por cada instancia que haya en el compartimento proporcionado, esté o no en funcionamiento.

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

Ejemplo de listado de módulos y vista general del agente "pandora-oracle-test2".

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

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: 404.5px; height: 29px;">**Nombre del módulo**</td><td style="width: 404.5px; height: 29px;">**Descripción**</td></tr><tr style="height: 35px;"><td style="width: 404.5px; height: 35px;">Agent pandora-oracle-test2 status

</td><td style="width: 404.5px; height: 35px;">Estado de la instancia</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Amount of RAM</td><td style="width: 404.5px; height: 29px;">Cantidad total de RAM de la instancia</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">CPU</td><td style="width: 404.5px; height: 29px;">Cantidad de núcleos</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">CPU Used</td><td style="width: 404.5px; height: 29px;">Cantidad de CPU usada, en %</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Disk Read</td><td style="width: 404.5px; height: 29px;">Métricas de lectura de disco, en bytes</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Disk Read I/O</td><td style="width: 404.5px; height: 29px;">Métricas de lectura de disco en lecturas por segundo</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Disk write I/O</td><td style="width: 404.5px; height: 29px;">Métricas de lectura de disco en escrituras por segundo</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Load average</td><td style="width: 404.5px; height: 29px;">Promedio de carga del sistema</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Memory Allocation Stalls</td><td style="width: 404.5px; height: 29px;">Número de veces que se llamó directamente a la recuperación de la página</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Memory Used</td><td style="width: 404.5px; height: 29px;">Memoria RAM usada en gigabytes</td></tr><tr style="height: 29px;"><td style="width: 404.5px; height: 29px;">Network Received</td><td style="width: 404.5px; height: 29px;">Cantidad de tráfico recibida, en bytes recibidos por segundo</td></tr><tr><td style="width: 404.5px;">Network Transmited</td><td style="width: 404.5px;">Cantidad de tráfico enviada, en bytes recibidos por segundo</td></tr></tbody></table>

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