Alertas de Webhook

Qué hace el canal de webhook

Un canal de alerta de webhook envía un POST HTTP con un cuerpo JSON a una URL que usted controla cada vez que uno de sus monitores cambia de estado: una comprobación falla, se recupera, se ejecuta degradada, o un certificado SSL está a punto de caducar. Es el canal más flexible, cualquier cosa que acepte un webhook JSON entrante puede consumirlo.

Forma del payload

Cada alerta se entrega como un único objeto JSON:

{
  "source": "loadfocus",
  "event": "check.failed",
  "check": { "id": "...", "name": "...", "url": "..." },
  "status": "failed",
  "location": "...",
  "timestamp": "..."
}

Los campos event y status le indican qué ha ocurrido (por ejemplo check.failed, check.recovered), de modo que su endpoint puede ramificar en función de ellos, abrir o resolver un incidente, publicar en un chat o almacenar el evento.

Añada el canal en LoadFocus

1. Vaya a la página de Alert Channels.
2. Haga clic en New Alert Channel y elija Webhook en la lista de canales.
3. Rellene los dos campos:
   • un nombre para reconocer el canal más adelante
   • la URL del endpoint que recibirá el POST (debe empezar por https://)
4. Haga clic en Save Configuration.

Justo después de crear el canal, LoadFocus le envía un POST de confirmación único, de modo que puede verificar que su endpoint recibe y analiza el payload sin necesidad de provocar un incidente real.

Funciona con cualquier webhook JSON

El mismo canal alimenta muchos destinos:

• Integraciones entrantes de PagerDuty y Opsgenie (o use los canales dedicados de PagerDuty y Opsgenie para la creación y resolución automática de incidentes de forma nativa)
• Herramientas de automatización como Zapier y n8n
• Su propio servicio, para ejecutar lógica personalizada en cada evento

Adjúntelo a sus comprobaciones

Crear el canal lo pone a disposición de todo su equipo. Para enrutar las alertas de un monitor concreto a su endpoint, seleccione el canal en la configuración de notificaciones de la comprobación, consulte Canales de alerta en una comprobación. Los canales de alerta se comparten entre los servicios de LoadFocus, así que las alertas de pruebas de carga y de velocidad de página pueden publicar en el mismo endpoint.

Solución de problemas

• No llega ningún POST de confirmación: confirme que la URL empieza por https:// y es accesible desde la Internet pública, y que su endpoint devuelve un estado 2xx.
• Devuelva una respuesta rápidamente (en menos de unos segundos) para que la entrega no se considere un tiempo de espera agotado.
• Los miembros del equipo con un rol de solo lectura pueden ver los canales, pero no pueden crearlos ni eliminarlos.