Cómo funciona el plugin AlertaTec

Es conocido que en nuestro país, Ecuador, estamos atravesando una pequeña crisis energética, lo que ha obligado a las empresas eléctricas locales a racionar la energía en diferentes horarios. En nuestro caso, como proveedores de servicios de red. Debemos garantizar que los datacenter de nuestros clientes cuenten con conectividad estable. Los equipos ya cuentan con ups que brinda servicio por 4 horas, pero en algunos casos la energía se va por tiempos mayores a eso además en horarios inesperados. Y, aunque la solución (si contaramos con los recursos suficientes) sería implementar ups de mayor capacidad, integrados con generadores automáticos. Debemos implementar una solución que permita conocer al minuto cuando un equipo ha dejado de funcionar. Otro de los aspectos a mencionar es que no todos los datacenter cuentan con direccionamiento público lo que podría facilitar el monitoreo general, pero qué hacer cuando no todos los centros de datos disponen de ip pública?.

En vista de las circunstancias actuales se ha pensado en implementar un monitor web que pueda recibir y anotar registros de conectividad. Y en caso de perdida de la conectividad, notificar al administrador de la red u otros usuarios que lo requieran.

El plugin está desarrollado para recibir notificaciones de equipos de red, lamentablemente no todos los equipos de red se pueden configurar. Pero el plugin ha sido probado con routers Mikrotik con routeros 6.47.8 (que permite notificar a través de la api de facturascripts y su respectivo token), con Router Mikrotik con routeros 6.40.8 (que no dispone algunas características de comunicacion http pero para el caso se usa envio de los parámetros a través de la url y con recepción haciendo uso del método GET) y con computadoras windows elaborando un .bat y con tareas de windows ejecutarlo cada minuto.

Pasos:

1. El primer paso que vamos a realizar es crear un registro de equipo dentro del Menú: Alertas->Equipos, como ejemplo nombre_equipo=equipo1 y tipo_equipo=computadora.
2. El segundo paso es crear un registro de correo electronico dentro del Menú: Alertas->Correos a quien le llegarán las notificaciones. Es necesario mencionar que la instancia de facturascripts ya debe tener configurada correctamente los servicios de correo como smtp y demás.
3. La tercera parte es configurar en el equipo que se desea monitorear sea router o computadora. A continuación se muestra un script batch de windows que genera una peticion http simple:

@echo off set "url=https://donde_tenga_instalado_facturascripts/RegistroSimple" set "nombre_equipo=equipo1" set "tipo_equipo=computadora"

curl "%url%?nombre_equipo=%nombre_equipo%&tipo_equipo=%tipo_equipo%" pause

La razón por la que se elabora un batch, es por que se requiere que el script se ejecute cada minuto. Una vez que esté correctamente elaborado se deberá crear una tarea de windows que ejecute mencionado batch con la frecuencia indicada (cada minuto). Por supuesto que en windows para escoger parece que lo mínimo fuera 5 minutos. Elija 5 y luego cambie manualmente el número a 1.

La manera más facil de comprobar que se genere un registro de alerta es desde el navegador, ejecutando el siguiente url que equivale exactamente al indicado en el batch anterior: https://donde_tenga_instalado_facturascripts/RegistroSimple?nombre_equipo=equipo1&tipo_equipo=computadora

Si ejecutamos el enlace en el navegador se creará un registro de alerta en la tabla alerta con el nombre de equipo.

4. El cuarto paso es habilitar la ejecución del cron de facturascripts para cada minuto. Se deberá leer detenidamente el funcionamiento del cron dependiendo del caso sea en hosting, en linux o en windows. Para cada caso es diferente.

Hasta aqui ya se podrá hacer uso del plugin sólo a través del controller RegistroSimple.

Para el caso de un router Mikrotik cuya versión sea routeros 6.40.8 también se usará el controller RegistroSimple creando un script con el siguiente codigo: /tool fetch url="https://donde_tenga_instalado_facturascripts/RegistroSimple?nombre_equipo=router1&tipo_equipo=router"\ http-method=post \ http-data="nombre_equipo=router1 \ output=user También se deberá crear un Scheduler que ejecute mencionado script cada minuto.

Para el caso de un router Mikrotik cuya versión es routeros 6.47.8 ya se puede usar la comunicación segura a través de la api de facturascripts, claro que en este caso se debe habilitar la api, y crear un Token que autorice la creación y edición de registros del modelo Alerta. El ejemplo de script para mencionado Mikrotik es: /tool fetch url="http://donde_tenga_instalado_facturascripts/api/3/registros" http-method=post http-header-field="Token:el_token_que_hayas_creado,Content-Type:application/x-www-form-urlencoded" http-data="nombre_equipo=router1&tipo_equipo=router".

Espero que este tutorial haya servido y me pongo a la orden para cualquier pregunta acerca del funcionamiento del plugin.