# MongoDB

# Introducción

**Este plugin tiene como finalidad monitorizar bases de datos MongoDB**, mediante métricas que son claves para conocer el rendimiento y estado de la bases de datos, como son el número de conexiones, número de consultas, latencia, network y tiempo de actividad. Estos datos se verán reflejados en PandoraFMS, en módulos que aportaran el valor estadístico, dentro de un agente que representará a cada base de datos.

Este plugin está desarrollado para usarse con Pandora FMS Discovery, por lo que a diferencia de otros plugins no genera agentes por XML, si no que todo lo descubierto se devuelve en la salida JSON del plugin.

# Prerrequisitos

Este plugin realiza conexiones remotas a las bases de datos a monitorizar, por lo que es necesario asegurar la conectividad entre el servidor de Pandora FMS y dichas bases de datos.

# Parámetros y configuración

**Parámetros**

<table border="1" id="bkmrk---conf-ruta-al-archi"><tbody><tr><td>--conf</td><td>Ruta al archivo de configuración</td></tr><tr><td>--target\_databases</td><td>Ruta al archivo de configuración que contiene los targets de las bases de datos</td></tr><tr><td>--target\_agents</td><td>Ruta al archivo de configuración que contiene los targets de los agentes</td></tr></tbody></table>

**Archivo de configuración (--conf)**

```
agents_group_id = < ID del grupo en el que se crearán los agentes >
interval = < Intervalo de monitorización de los agentes en segundos >
uri = < Cadena de conexión en formato URI; >
threads = < Número de hilos que se usaran para la creación de agentes >
modules_prefix = < Prefijo de módulos >
analyze_connections = < Activar con 1 para habilitar la monitorización de conexiones >
engine_uptime = < Activar con 1 para habilitar la monitorización del tiempo en ejecución >
query_stats = < Activar con 1 para habilitar la moitorización de estadísticas de consultas >
network = < Activar con 1 para habilitar la moitorización de estadísticas de redes >
latency = < Activar con 1 para habilitar la moitorización de estadísticas de latencia >
```

<span style="text-decoration: underline;">Ejemplo</span>

```
agents_group_id = 10
interval = 300
uri = mongodb://172.17.0.3:27017
threads = 1
modules_prefix = Mongodb.
analyze_connections = 1
network = 1
query_stats = 1
latency = 1
engine_uptime = 1
```

**Listado de bases de datos objetivo (--target\_databases)**

El contenido del fichero será un listado de bases de datos objetivo, separando cada base de datos por comas o por líneas. El formato para una base de datos será su nombre:

<span style="text-decoration: underline;">Ejemplo</span>

```
admin
db_analytics
db_geospatial
db_guides
```

**Listado de agentes objetivo (--target\_agents)**

El contenido del fichero será un listado de bases de nombres de agentes, separando cada agente por comas o por líneas. Estos nombres de agentes se usarán para volcar la información de cada base de datos objetivo en el nombre de agente indicado correspondiente, en lugar de dejar que el plugin genere los nombres de agentes de forma automática.

La posición de cada nombre de agente en el listado debe coincidir con la posición de la base de datos objetivo en su propio listado, es decir, el nombre para la primera base de datos objetivo será el primer nombre de este listado, teniendo en cuenta que las líneas en blanco son ignoradas.

<span style="text-decoration: underline;">Ejemplo</span>

```
agente1,,agente3
agente4
agente5,agente6,agente7,,agente9
```

# Ejecución manual

El formato de la ejecución del plugin es el siguiente:

```
./pandora_mongodb \
--conf < ruta al fichero de configuración > \
--target_databases < ruta al fichero de configuración que contiene las bases de datos objetivo > \
[ --target_agents < ruta al fichero de configuración de agentes > ] \
```

Por ejemplo:

```
./pandora_mongodb \
--conf /usr/share/pandora_server/util/plugin/mongodb.conf \
--target_databases /usr/share/pandora_server/util/plugin/targets.conf \
--target_agents /usr/share/pandora_server/util/plugin/target_agents.conf 
```

# Discovery

Este plugin puede integrarse con el *Discovery* de Pandora FMS.

Para ello se debe cargar el paquete ".disco" que puede descargar desde la librería de Pandora FMS:

[https://pandorafms.com/library/](https://pandorafms.com/library/)

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/scaled-1680-/HI1image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/HI1image.png)

Una vez cargado, se podrán monitorizar entornos de MongoDB creando tareas de *Discovery* desde la sección *Management &gt; Discovery &gt; Applications.*

Para cada tarea se solicitarán los siguientes datos mínimos:

- **MongoDB target strings :** Lista de objetivos Mongodb a monitorizar por la tarea. Será una lista separada por comas o por líneas. Cada base de datos objetivo se podrá definir con añadiendo su nombre.
- **Uri:** URI de conexión MongoDB estándar para conectar a un servidor de base de datos MongoDB

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/scaled-1680-/7dRimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/7dRimage.png)

También se podrá ajustar la configuración de la tarea para personalizar la monitorización deseada:

- **Max threads**: Para optimizar el tiempo de ejecución, se podrán configurar múltiples hilos para monitorizar los agentes de la tarea. Hay que tener en cuenta que configurar múltiples hilos puede aumentar el uso de CPU de la tarea.
- **Target agent**: Lista de agentes objetivo para los objetivos MongoDB a monitorizar. Es decir, los nombres con los que se generarán los agentes de cada objetivo definido en la tarea. Será una lista separada por comas o por líneas. La posición de los nombres en la lista deberá coincidir con la posición de los objetivos MongoDB en su lista, es decir, el primer nombre se usará para el primer objetivo y así sucesivamente. Si la lista se separa por líneas, las líneas en blanco se ignorarán. Si no se especifica un nombre de agente para un objetivo se usará su nombre como nombre del agente.
- **Custom module prefix**: Texto incluido como prefijo para los todos los nombres de módulos generados. Es útil para localizar los módulos generados por la tarea o distinguirlos de otros.
- **Check engine uptime**: Si se activa monitorizará el uptime de los objetivos.
- **Retrieve query statistics**: Si se activa monitorizará las estadísticas de consultas.
- **Analyze connections**: Si se activa monitorizará las conexiones.
- **Retrieve latency statistics**: Si se activa monitorizará la latencia.
- **Retrieve network statistics**: Si se activa monitorizará las redes.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/scaled-1680-/qQ7image.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/qQ7image.png)

Las tareas que se completen exitosamente dispondrán de un sumario de ejecución con la siguiente información:

- **Total agents**: Total de agentes generados por la tarea.
- **Targets up**: Total de objetivos a los que ha sido posible conectar.
- **Targets down**: Total de objetivos a los que no ha sido posible conectar.

[![image.png](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/scaled-1680-/B2Qimage.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2023-10/B2Qimage.png)

Las tareas que no se completen exitósamente dispondrán de un sumario de ejecución registrando los errores producidos.

# Agentes y módulos generados por el plugin

El plugin creará un agente por cada base de datos objetivo. Ese agente contendrá los siguientes módulos

Si esta activado **engine\_uptime**:

<table border="1" id="bkmrk-uptime-muestra-el-ti" style="border-collapse: collapse; width: 100%; height: 29.7969px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">uptime</td><td style="height: 29.7969px;">Muestra el tiempo en el que el servidor MongoDB ha estado en funcionamiento desde su última reinicialización o inicio.</td></tr></tbody></table>

Si esta activado **query\_stats**:

<table border="1" id="bkmrk-queries-command-cant" style="border-collapse: collapse; width: 100%; height: 178.781px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries command</td><td style="height: 29.7969px;">Cantidad de consultas en MongoDB que implican operaciones de comando.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries delete </td><td style="height: 29.7969px;">Cantidad de operaciones de eliminación realizadas en la base de datos MongoDB.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries getmore</td><td style="height: 29.7969px;">Cantidad de operaciones "getmore" ejecutadas, "getmore" se utiliza para obtener más resultados de una consulta cuando los resultados no caben en un solo lote.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries insert</td><td style="height: 29.7969px;">Cantidad de operaciones de inserción realizadas en la base de datos MongoDB.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries query</td><td style="height: 29.7969px;">Cantidad de operaciones de consulta realizadas en la base de datos MongoDB.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">queries update</td><td style="height: 29.7969px;">Cantidad de operaciones de actualización realizadas en la base de datos MongoDB.</td></tr></tbody></table>

Si esta activado **analyze\_connections**:

<table border="1" id="bkmrk-connections-availabl" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr><td>connections available</td><td>Número de conexiones disponibles en el servidor MongoDB</td></tr><tr><td>connections current</td><td>Número actual de conexiones activas en el servidor MongoDB</td></tr><tr><td>connections totalCreated</td><td>Cantidad total de conexiones que se han creado en el servidor MongoDB desde que se inició o reinició.</td></tr><tr><td>MONGODB connection</td><td>Disponibilidad de la conexión actual</td></tr></tbody></table>

Si esta activado **latency**:

<table border="1" id="bkmrk-commands-latency-lat" style="border-collapse: collapse; width: 100%; height: 262.766px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 46.5938px;"><td style="height: 46.5938px;">commands latency</td><td style="height: 46.5938px;">Latencia promedio de las operaciones de tipo comando en MongoDB.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">commands ops</td><td style="height: 46.5938px;">Número total de operaciones de tipo comando realizadas en MongoDB.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">reads latency</td><td style="height: 29.7969px;">Latencia promedio de las operaciones de lectura en MongoDB.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">reads ops</td><td style="height: 46.5938px;">Cantidad total de operaciones de lectura realizadas en MongoDB.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">writes latency</td><td style="height: 46.5938px;">Latencia promedio de las operaciones de escritura en MongoDB.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">writes ops</td><td style="height: 46.5938px;">Cantidad total de operaciones de escritura realizadas en MongoDB.</td></tr></tbody></table>

Si esta activado **network**:

<table border="1" id="bkmrk-bytesin-cantidad-tot" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">bytesIn</td><td style="height: 29.7969px;">Cantidad total de bytes que han sido recibidos por el servidor MongoDB desde que se inició o se reinició.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">bytesOut</td><td style="height: 29.7969px;">Cantidad total de bytes que han sido enviados por el servidor MongoDB hacia los clientes o aplicaciones desde que se inició o se reinició.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">numRequests</td><td style="height: 29.7969px;">Número total de solicitudes o peticiones que ha recibido el servidor MongoDB desde que se inició o se reinició.</td></tr></tbody></table>