Plugin Docker

• Introducción
• Matriz de compatibilidad
• Pre requisitos
• Configuración
• Ejecución manual
• Ejecución programada
• Módulos generados por el plugin

Introducción

Matriz de compatibilidad

Este plugin se ha desarrollado utilizando Docker versión 18.03.1-ce, build 9ee9f40

Pre requisitos

• Requiere lanzarse desde un equipo con docker instalado.
• Puede lanzarlo desde máquinas remotas utilizando ​docker_machine​.

Configuración

Configuraciones generales del plug-in

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

docker
Ubicación del binario docker completa, si existe en el PATH de sistema puede dejar el valor por defecto ​‘docker​’

module_interval
Es un factor multiplicativo del valor del intervalo del agente. Define el intervalo de ejecución de los módulos. Evitará que los módulos se vayan a desconocido si tenemos que el intervalo de ejecución del plugin es mayor que el del agente.

module_group
Define el grupo de módulos en el que se clasificarán los módulos generados por el plugin. Debe estar previamente definido en Pandora FMS.

mode

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).

Ejecución manual

Para ejecutar el plugin configure el archivo de configuración según las instrucciones precedentes. 

./docker_stats --conf docker_stats.conf

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

Ejecución programada

Se puede ejecutar como ​module_plugin​ en un agente, o desde el cron de sistema.

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 

Luego agregamos el nuevo plugin y le damos click en add

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

Con esto se agregará correctamente el plugin.

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

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

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

Módulos generados por el modo  Global

Docker blocks in	Escritura del disco de Docker
Docker blocks in Incremental	Escritura del disco de Docker Incremental
Docker blocks out	Lectura del disco de Docker
Docker blocks out Incremental	Lectura del disco de Docker Incremental
Docker cpu usage	Uso de CPU de Docker
Docker memory usage	Uso de memoria RAM de Docker
Docker network input	Tráfico de entrada de Docker
Docker network input Incremental	Tráfico de entrada de Docker Incremental
Docker network output	Tráfico de salida de Docker
Docker network output Incremental	Tráfico de salida de Docker Incremental
Docker State	1 si esta activo el docker 0 si no lo esta
Docker Container running	Cantidad de contenedores activos

Módulos generados por el modo container