Configuración en Pandora FMS

Para configurar esto como plugin de Servidor en PandoraFMS, se deben seguir los siguientes pasos :

1. Subir el plugin a PandoraFMS, por ejemplo en la siguiente ruta:

/usr/share/pandora_server/util/plugin

2. Crear un plugin de servidor en el apartado Plugins:

    3. Añadir nombre, descripción y timeout:

Este plugin puede tardar un tiempo en ejecutarse, por lo que se recomienda configurar un timeout de al menos 20 segundos. Es posible que el parámetro global "plugin_timeout" del pandora_server.conf deba ser ajustado también.

Descripción utilizada en el ejemplo:

This plugin generates modules dynamically in the agent it's created in. Based on the ifName, it generates modules for:
- ifOperStatus
- ifInOctets (ifHCInOctets, if available)
- ifOutOctets (ifHCOutOctets, if available)
The value returned by the module represents the number of modules generated.

4. Se añade la ruta del plugin en el comando y los parámetros necesarios para la ejecución de este. 

Este ejemplo se configurará para monitorización de interfaces con SNMPv2, indicando filtros para las interfaces y umbrales de estado para los módulos generados. Se utilizarán las macros de servidor _agentname_ y _address_ para no tener que indicar manualmente el nombre de agente y la dirección IP del dispositivo en cada ejecución:

Para cada parámetro se debe configurar una macro, siendo la sintaxis de esta macro la siguiente : _fieldx_, siendo x el numero posicional del parámetro.

Plugin parameters utilzados en el ejemplo:

-agent "_agentname_" -h "_address_" -v "_field1_" -c "_field2_" -only "_field3_" -reject "_field4_" -wmin "_field5_" -wmax "_field6_" -cmin "_field7_" -cmax "_field8_"

5. Se configuran las macros anteriores, añadiendo en cada una el valor del parámetro:

Campos incluidos en el ejemplo:

• Field 1
  • Description: SNMP version
  • Default value: 2c
• Field 2
  • Description: SNMP community
• Field 3:
  • Description: Filter interfaces by name
  • Help: Optional: allows filtering interfaces by name, separated by commas. For example: ‘ge,fe’, will only generate modules for interfaces whose name contains ‘ge’ or ‘fe’.
    
• Field 4:
  • Description: Exclude interfaces by name
  • Help: Optional: allows to exclude interfaces by name, separated by comma. For example: ‘ge,fe’ will generate modules for all available interfaces except if their name contains ‘ge’ or ‘fe’.
• Field 5:
  • Description: Warning threshold (min)
  • Help: Optional: Allows to specify the min threshold for Warning status in the generated modules.
• Field 6:
  • Description: Warning threshold (max)
  • Help: Optional: Allows to specify the max threshold for Warning status in the generated modules.
• Field 7:
  • Description: Critical threshold (min)
  • Help: Optional: Allows to specify the min threshold for Critical status in the generated modules.
• Field 8:
  • Description: Critical threshold (max)
  • Help: Allows to specify the max threshold for Critical status in the generated modules.

6. Una vez configurado se debe crear un módulo en un agente que ejecute el plugin. En el menú de módulos de un agente, crear un módulo de tipo plugin server:

7. En el menú de configuración del módulo, indicar un nombre, seleccionar el plugin y rellenar los campos requeridos:

8. Una vez creado el módulo, el plugin se ejecutará y generará los módulos que coincidan con los filtros indicados: