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": "..."
}

El campo event es uno de check.failed, check.degraded, check.recovered, ssl.expiry, domain.expiry, sla.breach, sla.recovered o test. En los eventos de comprobación, status es failed, degraded o passed (una recuperación es passed). Algunos eventos añaden un objeto details, y los campos que no aplican, como status en un vencimiento de SSL, son null. Su endpoint puede ramificar en función de estos campos para abrir o resolver un incidente, publicar en un chat o almacenar el evento. No hay un campo para cabeceras personalizadas ni para un secreto de firma, así que mantenga privada la URL de su endpoint.

Añada el canal en LoadFocus

1. Vaya a la página de Alert Channels.
2. Haga clic en Nuevo canal de alerta y elija Webhook como tipo de canal.
3. Rellene los dos campos:
   • un Nombre para reconocer el canal más adelante
   • la URL del webhook que recibirá el POST (debe empezar por https://)
4. Haga clic en Guardar canal.

Justo después de crear el canal, LoadFocus le envía un POST de confirmación único (evento test), de modo que puede verificar que su endpoint recibe y analiza el payload sin necesidad de provocar un incidente real. Haga clic en Probar en la fila del canal para enviarlo de nuevo.

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; esos dos son solo de pago, el canal de webhook está en todos los planes)
• 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 Internet (las direcciones privadas e internas se bloquean) y que su endpoint devuelve un estado 2xx. No se siguen las redirecciones, así que use la URL final.
• Responda en un máximo de 10 segundos; si no, la entrega se considera 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.