Uso en Pandora FMS
Lo primero que debemos hacer es subir el script a una ruta accesible en la máquina donde tengamos desplegado el servidor de Pandora FMS, en mi caso lo colocaré en/usr/share/pandora_server/util/pandora-telegram-cli.py. No obstante, puede usar cualquier ubicación siempre que el servidor de pandora tenga acceso a esta.
También, debemos asegurarnos de que tenemos las dependencias instaladas para la ejecución del plugin o que contamos con la versión compilada en su defecto. Para comprobarlo simplemente ejecutamos el plugin sin ningún parámetro, el cual debe devolvernos una respuesta similar a:
python3 pandora-telegram-cli.py
En caso de tener algún error ir a la sección de configuración del plugin de esta guía donde se describe cómo instalar las dependencias.
Teniendo el plugin en el servidor y funcionando correctamente, ahora tenemos que declararlo en la consola web de Pandora FMS.
Una vez accedemos como administrador (o con permisos de gestión de alertas) iremos a la sección de Alertas > Comandos.
Hacemos clic en crear nuevo comando.
Aquí definiremos la ejecución del script y los parámetros que utilizaremos haciendo uso de las macros de PandoraFMS.
Mi definición será:
Aquí definimos un campo por cada parámetro que va a tener el plugin. Si no quisiesemos usar alguno de los parámetros opcionales simplemente valdría con dejarlo en blanco, o no definirlo.
Ahora podemos ir a configurar la acción usando nuestro comando. Nos vamos a Alertas > Acciones.
Pulsamos en Crear.
Seleccionamos el comando que queremos usar, en este caso el que acabamos de crear para el bot de Telegram.
Aquí podremos definir y modificar los campos correspondientes a los field que hemos definido, yo lo he dejado como configuración por defecto en el comando, por lo que podemos usarlo con lo que hemos definido, pero podremos cambiarlo a nivel de acciones específicas si queremos cambiar los datos que se envían para cada acción y cambiar el texto de disparo y el de recuperación.
Teniendo la acción configurada simplemente podemos ir a un módulo o política y aplicar esta acción con el template correspondiente.
Para más información acerca de la configuración de alertas vaya a la documentación oficial de PandoraFMS:
