Ir al contenido

Un canal de alerta de webhook envía un POST HTTP con un cuerpo JSON a una URL que tú controlas cada vez que uno de tus 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.

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. Tu 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 mantén privada la URL de tu endpoint.

  1. Ve a la página de Alert Channels.
  2. Haz clic en Nuevo canal de alerta y elige Webhook como tipo de canal.
  3. Rellena 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. Haz clic en Guardar canal.

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

El mismo canal alimenta muchos destinos:

  • Integraciones entrantes de PagerDuty y Opsgenie (o usa el canal dedicado de PagerDuty para la creación y resolución automática de incidentes de forma nativa; es solo de pago, el canal de webhook está en todos los planes. Ya no se pueden añadir canales nuevos de Opsgenie)
  • Herramientas de automatización como Zapier y n8n
  • Tu propio servicio, para ejecutar lógica personalizada en cada evento

Crear el canal lo pone a disposición de todo tu equipo. Para enrutar las alertas de un monitor concreto a tu endpoint, selecciona el canal en la configuración de notificaciones de la comprobación, consulta 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.

  • No llega ningún POST de confirmación: confirma que la URL empieza por https:// y es accesible desde Internet (las direcciones privadas e internas se bloquean) y que tu endpoint devuelve un estado 2xx. No se siguen las redirecciones, así que usa la URL final.
  • Responde 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.