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

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

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

<p class="callout warning">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.</p>

[![Captura de pantalla 2025-05-22 a las 13.40.05.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/scaled-1680-/captura-de-pantalla-2025-05-22-a-las-13-40-05.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/captura-de-pantalla-2025-05-22-a-las-13-40-05.png)

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:

<p class="callout info">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.</p>

[![Captura de pantalla 2025-05-22 a las 13.43.29.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/scaled-1680-/captura-de-pantalla-2025-05-22-a-las-13-43-29.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/captura-de-pantalla-2025-05-22-a-las-13-43-29.png)

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:**

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

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:**

[![Captura de pantalla 2025-05-22 a las 16.05.33.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/scaled-1680-/Htucaptura-de-pantalla-2025-05-22-a-las-16-05-33.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/Htucaptura-de-pantalla-2025-05-22-a-las-16-05-33.png)

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

[![Captura de pantalla 2025-05-22 a las 15.51.20.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/scaled-1680-/captura-de-pantalla-2025-05-22-a-las-15-51-20.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/captura-de-pantalla-2025-05-22-a-las-15-51-20.png)

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

[![Captura de pantalla 2025-05-22 a las 15.56.12.png](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/scaled-1680-/captura-de-pantalla-2025-05-22-a-las-15-56-12.png)](https://pandorafms.com/guides/public/uploads/images/gallery/2025-05/captura-de-pantalla-2025-05-22-a-las-15-56-12.png)