Un complemento (plugin) de servidor es un programa o guión con comandos (script) ubicado en el servidor (por defecto en /usr/share/pandora_server/util/plugin
) y ejecutado por éste, al que podemos pasarle una serie de parÔmetros. Devuelve un único valor simple, ya sea numérico, booleano o de tipo texto.
Para usar los plugins, debemos activar el servidor especĆfico pluginserver
en la configuración del servidor:
/etc/pandora/pandora_server.conf.
Pandora FMS trae por defecto unos cuantos plugins, como iface_bandwith.pl
y udp_nmap_plugin.sh
, pero tambiƩn se pueden desarrollar manualmente. La manera mƔs fƔcil de comprobar su funcionamiento es ejecutƔndolos directamente desde la terminal, como mƔs adelante harƔ Pandora FMS. En general, los plugins suelen incluir una ayuda al ejecutarlos con -help
, -h
o sin parƔmetros, lo cual facilita su uso.
Para utilizar un plugin en Pandora FMS hay que registrarlo, y esto se puede hacer de dos maneras:
Registro manual
Se realiza en Servers/Plugins. En el menĆŗ de crear plugin debemos indicar el nombre (junto con otros parĆ”metros como el tipo de plugin, el timeout y una descripción) asĆ como el comando que ejecuta y los parĆ”metros a utilizar con Ć©l. Ćstos se especifican en Plug-in command (donde hay que indicar la ruta completa al plugin) y en Plug-in parameters (el cual acepta el uso de macros), respectivamente.
Por ejemplo, si quisiĆ©ramos crear un plugin que ejecutara un chequeo remoto UDP utilizando NMAP a la dirección IP y el puerto que deseemos, tendrĆamos que completar el registro de esta manera:
- EscogerĆamos como nombre de plugin “Chequeo de puerto UDP”, por ejemplo.
- En Plug-in command, escribirĆamos la ruta /usr/share/pandora_server/util/plugin/udp_nmap_plugin.sh, la cual lleva a un plugin instalado por defecto con Pandora FMS.
- En Plug-in parameters, escribirĆamos
-t _field1_ -p _field2_
para que el plugin pueda reutilizarse para todos los puertos y direcciones IP que necesitemos. MÔs abajo podemos añadir una descripción a estos macros para saber qué información exigen. - En el espacio Command preview veremos cómo ejecutarÔ Pandora FMS el comando:
/usr/share/pandora_server/util/plugin/udp_nmap_plugin.sh -t _field1_ -p _field2_
Ya tenemos registrado el plugin. Para usarlo, cree un módulo de tipo plugin en el agente que desee monitorizar. Al escogerlo, se le darÔ la opción de escoger la información que sustituirÔ a los macros _field1_
y _field2_
, en este caso, la dirección IP y el puerto, respectivamente.
Tenga en cuenta que algunos plugins pueden tardar bastante tiempo en terminar su ejecución, por lo que el timeout de ejecución del servidor (pandora_server.conf
) siempre debe ser mÔs alto que cualquiera de los valores definidos en un plugin. En caso contrario, el servidor detendrÔ la ejecución del plugin.
Registro mediante un fichero .pspz
El formato PSPZ se creó para abstraer la instalación de plugins por parte de usuarios con poco conocimiento. Consiste en un fichero .zip
con extensión .pspz
que contiene el script y otros ficheros que necesite el plugin para funcionar, junto con un fichero denominado plugin_definition.ini
. Este fichero contiene la especificación del plugin y de los módulos que se pueden emplear con Ć©l, para incorporarlos a la librerĆa. Contiene la definición de la interfaz completa, y al instalarlo a travĆ©s de la consola, copia el plugin
a un directorio del disco.
El registro con ficheros .pspz
se realiza desde la consola, en Servers/Register plug-in, donde habrƔ que subir el archivo para que Pandora FMS lo utilice. Por defecto, el plugin se copiarƔ sobre el servidor donde estƔ la consola. Si el servidor de plugins se encuentra en otra mƔquina, habrƔ que copiar o sincronizar el directorio /attachment/plugin
de la Consola web.
- VƩase tambiƩn: