Collectd
Plugin para integrar collectd con Pandora FMS.
- Introducción
- Matriz de compatibilidad
- Pre requisitos
- Parámetros
- Ejecución manual
- Configuración en PandoraFMS
- Agente y módulos generados por el plugin
Introducción
El plugin pandora_collectd se encarga de integrar la recolección de collectd con el servidor y los agentes de Pandora FMS.
Nos encontramos ante un plugin de Servidor y Agente Software.
Matriz de compatibilidad
Sistemas donde se ha probado | CentOS 7, Rocky Linux 8 y Ubuntu 22.04 |
Sistemas donde funciona | Cualquier sistema Linux x86_64 |
Este plugin no es compatible con sistemas ARM
Pre requisitos
- Tener instalado y configurado Collectd.
- En los sistemas operativos Linux más recientes (como Rocky Linux 8 o Ubuntu 22.04) es necesario instalar la dependencia
collectd-utils
. Esta dependencia no es necesaria, por ejemplo, en CentOS 7. - Permisos de ejecución del plugin
pandora_collectd
.
Parámetros
-h, --help |
Información de ayuda de los argumentos del plugin. |
-c, --collectdctl |
Ruta de collectdctl . |
-r, --add_regexp | Expresión regular (regexp) para añadir métricas (por defecto .* ). |
-R, --ignore_regexp | Expresión regular (regexp) para eliminar métricas (por defecto ninguna). |
-d, --agent_description | Descripción del agente creado por el plugin (por defecto "Agent from pandora_collectd"). |
-a, --agent_alias | Nombre del agente creado por el plugin (por defecto pandora_collectd ). |
-i, --tentacle_ip | Dirección IP del servidor de Tentacle (por defecto 127.0.0.1). |
-p, --tentacle_port | Puerto de Tentacle (por defecto 41121). |
-O, --tentacle_extra_opts | Opciones extra de Tentacle (por defecto ninguna) |
-v, --verbose | Muestra todos los valores obtenidos por pantalla. |
Expresiones regulares de Python https://docs.python.org/3/library/re.html#regular-expression-syntax
Ejecución manual
Ejecución por defecto
./pandora_collectd
Ejecución con expresiones regulares
./pandora_collectd -r ".*cpu.*" -R ".*memory.*"
Ejecución con nombre de agente, descripción y dirección de Tentacle
./pandora_collectd -a Monitores_Servidor -d "Monitores del Servior Web" -i 127.0.0.1
Configuración en PandoraFMS
Este plugin podemos configurarlo tanto como plugin de servidor como plugin de agente.
Plugin de Servidor
1. Podemos subir el plugin a nuestro servidor en la ruta por defecto:
/usr/share/pandora_server/util/plugin
2. Nos dirigimos al apartado de plugins y añadimos uno nuevo:
3. Añadimos el nombre, la descripción y el timeout del plugin:
4. Introducimos la ruta de ejecución del plugin y todos los parámetros que vayamos a usar:
Al ejecturase el plugin en el servidor de Pandora FMS en este caso, podemos introducir los parametros en el apartado "Plugin Command" directamente.
Si pese a esto, vamos a querer modificar los parametros del plugin, los introduciremos con macros en el apartado "Plugin Parameters" para posteriormente indicarlos en la creación del módulo.
5. Creamos el módulo de plugin en alguno de nuestros agentes de Pandora FMS:
6. Indicamos el plugin y los datos que queramos modificar y creamos el módulo:
Plugin de Agente
1. Podemos subir el plugin a nuestro agente en la ruta por defecto:
/usr/share/pandora_agent/plugins
2. Accedemos a la configuración de Plugins de nuestro agente y añadimos el plugin con los parametros que queramos:
Agente y módulos generados por el plugin
La ejecución del plugin (en agente o servidor) dará como resultado la creación de un Agente de Pandora FMS, con los módulos correspondientes a la recolección de monitores de collectd: