# Plugin Docker

# Introducción

<div id="bkmrk-ver.-230821"><div>**Ver.** 230821</div><div>  
</div></div><div id="bkmrk-"></div><div id="bkmrk-este-plugin-sirve-pa">Este plugin de agente sirve para monitorizar las estadísticas de un entorno Docker.</div><div id="bkmrk--0"></div><div id="bkmrk--1"></div><div id="bkmrk-tipo%3A-plugin-mixto">**Tipo:** plugin mixto</div>

# Matriz de compatibilidad

<span dir="ltr" role="presentation">Este plugin se ha desarrollado utilizando Docker versión 18.03.1-ce, build 9ee9f40</span>

# Pre requisitos

- <span dir="ltr" role="presentation">**Requiere** lanzarse desde un equipo con **docker instalado.**</span>
- <span dir="ltr" role="presentation">Puede lanzarlo desde máquinas remotas utilizando ​</span><span dir="ltr" role="presentation">docker\_machine​</span><span dir="ltr" role="presentation">.</span>

# Configuración

#### **Configuraciones generales del plug-in**

```bash
## Lanzar un precomando antes de invocar comandos docker
docker = Docker
##  Intervalo entre módulos
module_interval = 1
## Module_tags = docker,stats
module_group = Docker
## Modo de ejecución
## global: Generará módulos que resumen el rendimiento de todos los contenedores Docker en su conjunto.
## container: Generará módulos individuales para cada contenedor en ejecución (CPU, Memoria, Net In/Out, Block In/Out por contenedor).
mode = global
```

**<span dir="ltr" role="presentation">docker</span>**   
<span dir="ltr" role="presentation">Ubicación del binario docker completa, si existe en el PATH de sistema puede dejar </span><span dir="ltr" role="presentation">el valor por defecto ​</span><span dir="ltr" role="presentation">‘docker​</span><span dir="ltr" role="presentation">’</span>

**<span dir="ltr" role="presentation">module\_interval</span>**   
<span dir="ltr" role="presentation">Es un factor multiplicativo del valor del intervalo del agente. Define el intervalo de </span><span dir="ltr" role="presentation">ejecución de los módulos. Evitará que los módulos se vayan a desconocido si tenemos que </span><span dir="ltr" role="presentation">el intervalo de ejecución del plugin es mayor que el del agente.</span>  
  
**<span dir="ltr" role="presentation">module\_group</span>**   
<span dir="ltr" role="presentation">Define el grupo de módulos en el que se clasificarán los módulos generados por el </span><span dir="ltr" role="presentation">plugin. Debe estar previamente definido en Pandora FMS.</span>

**<span dir="ltr" role="presentation">mode</span>**

<span dir="ltr" role="presentation">Indica el modo el cual se ejecuta el plugin siendo **general** Generará módulos que resumen el rendimiento de todos los contenedores Docker en su conjunto y **contenedor** Generará módulos individuales para cada contenedor en ejecución (CPU, Memoria, Net In/Out, Block In/Out por contenedor).</span>

<span dir="ltr" role="presentation">  
  
</span>

# Ejecución manual

<span dir="ltr" role="presentation">Para ejecutar el plugin configure el archivo de configuración según las instrucciones </span><span dir="ltr" role="presentation">precedentes.</span>

```
./docker_stats --conf docker_stats.conf
```

Al ejecutar como **plugin de agente**, nos devolverá un XML:

[![Screenshot 2025-07-21 075409.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/screenshot-2025-07-21-075409.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/screenshot-2025-07-21-075409.png)

# Ejecución programada

<span dir="ltr" role="presentation">Se puede ejecutar como ​</span><span dir="ltr" role="presentation">module\_plugin​</span><span dir="ltr" role="presentation"> en un agente, o</span> <span dir="ltr" role="presentation">desde el cron de sistema.</span>

# Módulos generados por el plugin

Teniendo 2 modos, el **global** por defecto, combinará la información de todos los contenedores activos, mientras que en el modo **container**, separa en diferentes módulos la información de cada contenedor.

Tenemos que agregar en en plugin dando click en la pestaña **plugin**

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

Luego agregamos el nuevo plugin y le damos click en **add**

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

Para finalizar, hay que darle click al botón **update plugin**

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

Con esto se agregará correctamente el plugin.

Otra forma de agregarlo es ir a la pestaña de configuración remota

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

y agregar el plugin con el nombre de **module\_plugin** más la ubicación del binario más el archivo conf

Ejemplo

```
module_plugin /usr/share/pandora_agent/plugins/docker_stats --conf /usr/share/pandora_agent/plugins/docker_stats.conf
```

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

Finalizando, dándole click en el botón **update** para que se registre el cambio.

Módulos generados por el modo  **Global**

<table border="1" id="bkmrk-docker-blocks-in%C2%A0-es" style="border-collapse: collapse; width: 100%; height: 180px;"><tbody><tr style="height: 35px;"><td style="width: 50%; height: 35px;"><span dir="ltr" role="presentation">Docker blocks in</span>

</td><td style="width: 50%; height: 35px;">Escritura del disco de Docker</td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker blocks in Incremental</span>

</td><td style="width: 50%;">Escritura del disco de Docker Incremental</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><span dir="ltr" role="presentation">Docker blocks out</span> </td><td style="width: 50%; height: 29px;">Lectura del disco de Docker</td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker blocks out Incremental</span></td><td style="width: 50%;">Lectura del disco de Docker <span dir="ltr" role="presentation">Incremental</span></td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><span dir="ltr" role="presentation">Docker cpu usage</span></td><td style="width: 50%; height: 29px;">Uso de CPU de Docker</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><span dir="ltr" role="presentation">Docker memory usage</span></td><td style="width: 50%; height: 29px;">Uso de memoria RAM de Docker</td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><span dir="ltr" role="presentation">Docker network input</span></td><td style="width: 50%; height: 29px;">Tráfico de entrada de Docker</td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker network input Incremental</span></td><td style="width: 50%;">Tráfico de entrada de Docker <span dir="ltr" role="presentation">Incremental</span></td></tr><tr style="height: 29px;"><td style="width: 50%; height: 29px;"><span dir="ltr" role="presentation">Docker network output</span></td><td style="width: 50%; height: 29px;">Tráfico de salida de Docker</td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker network output Incremental</span></td><td style="width: 50%;">Tráfico de salida de Docker <span dir="ltr" role="presentation">Incremental</span></td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker State</span></td><td style="width: 50%;">1 si esta activo el docker 0 si no lo esta</td></tr><tr><td style="width: 50%;"><span dir="ltr" role="presentation">Docker Container running</span></td><td style="width: 50%;">Cantidad de contenedores activos</td></tr></tbody></table>

[![Screenshot 2025-07-21 075343.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/scaled-1680-/screenshot-2025-07-21-075343.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-07/screenshot-2025-07-21-075343.png)

Módulos generados por el modo **container**

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