Cómo enviar alertas de HostTracker a Slack

Cómo funciona la integración

Cuando añades un contacto nuevo en HostTracker y eliges Slack en el selector de tipo de contacto, no estás creando un tipo de contacto distinto por detrás. Se guarda como un contacto HTTP, y HostTracker lo reconoce como un destino de Slack porque la dirección que pegaste empieza por https://hooks.slack.com/. Ese único detalle es lo que cambia el formato del mensaje de un payload JSON genérico a un mensaje compatible con Slack, por lo que la configuración solo necesita una URL y nada más que ajustar.

Configurar alertas de Slack paso a paso

1. En Slack, abre api.slack.com/apps y elige Create New App, y luego From scratch. Dale un nombre como "HostTracker alerts" y elige el espacio de trabajo donde quieres que lleguen las alertas.
2. En la configuración de la app, abre Incoming Webhooks y actívalo.
3. Pulsa Add New Webhook to Workspace, elige el canal que debe recibir las alertas de HostTracker, y pulsa Allow.
4. Slack genera una URL de webhook que empieza por https://hooks.slack.com/services/. Cópiala.
5. En HostTracker, añade un contacto nuevo y elige Slack en la lista de tipos de contacto, y luego pega la URL del webhook en el campo de dirección.
6. Guarda el contacto, y usa Send test para confirmar que un mensaje de prueba llega al canal antes de depender de él.

Si ya tienes un webhook creado mediante el flujo antiguo, ahora obsoleto, del directorio de apps de Slack, su URL sigue funcionando tal cual; pégala de la misma forma. Un webhook nuevo tiene que pasar por el flujo basado en app de arriba, ya que Slack ha retirado el flujo clásico para configuraciones nuevas.

Cómo se ve una alerta en el canal

Cada alerta llega como un mensaje corto de texto plano, no como una tarjeta con formato. Una alerta Down nombra el sitio, la hora y una descripción del fallo, por ejemplo un tiempo de espera de conexión agotado o un código de error HTTP. Una alerta Up nombra el sitio, la hora en que se recuperó, y cuánto tiempo había estado caído. Un recordatorio de "sigue caído" repite la duración de la caída y el error, así que puedes ver si algo ha cambiado sin abrir HostTracker.

Si varios de tus monitores fallan en una ventana corta, HostTracker puede combinarlos en un solo mensaje en lugar de publicar uno tras otro. Esa es la opción "Group events" del contacto. Los usuarios más avanzados también pueden sustituir el mensaje por defecto por una plantilla personalizada, siempre que siga siendo un JSON válido de webhook de Slack con un campo text.

Elegir qué eventos llegan al canal

Un contacto de Slack, como cualquier otro contacto, se suscribe a monitores concretos y tipos de evento concretos en lugar de a toda tu cuenta. Hay tres eventos entre los que elegir: Down (el sitio acaba de caerse), Up (el sitio se recuperó), y Repeat (un recordatorio de que sigue caído). Un patrón habitual es enrutar Down y Up a un canal compartido del equipo para que todo el mundo vea el inicio y el fin de una incidencia, y dejar Repeat desactivado si los recordatorios serían ruido, o activado para un canal dedicado a una incidencia que necesita atención constante hasta que se resuelva.

Solución de problemas

Unas cuantas cosas rompen una integración de Slack sin ninguna señal visible, porque Slack no le pasa a HostTracker ningún error que pueda mostrarte dentro de la app:

• Un webhook revocado o eliminado. Si se eliminó la app de Slack o se regeneró el webhook, la URL antigua deja de aceptar publicaciones. HostTracker sigue enviando a ella y la entrega falla, sin ningún aviso dentro de HostTracker de que el canal se ha quedado en silencio. Ejecuta Send test de nuevo cada vez que alguien toque la configuración de la app de Slack, o periódicamente como costumbre.
• El canal equivocado. Un Incoming Webhook está ligado al canal que elegiste al crearlo y no se puede redirigir después. Si las alertas están llegando al sitio equivocado, crea un webhook nuevo para el canal correcto en Slack y pega la URL nueva en el contacto.
• Un canal archivado. Slack deja de aceptar publicaciones de webhook en cuanto se archiva el canal de destino. Desarchívalo, o crea un webhook nuevo apuntando a otro canal activo y actualiza el contacto.
• Sin permiso para añadir apps. Algunos espacios de trabajo de Slack restringen quién puede instalar apps nuevas o aprobar el acceso de webhooks. Si el paso 1 o el paso 3 de arriba aparece en gris o bloqueado, pide a un administrador del espacio de trabajo que cree el webhook por ti o que te dé permiso para gestionar apps.

Nada de esto aparece como un error dentro de HostTracker en sí. El contacto sigue pareciendo guardado y activo, ya que HostTracker no tiene forma de saber que Slack rechazó una entrega de su lado. Ejecutar Send test después de cualquier cambio del lado de Slack es la única forma fiable de confirmar que el canal sigue recibiendo alertas.

Lecturas relacionadas

Slack funciona mejor como un canal más dentro de una configuración de notificaciones más amplia que como el único. Consulta la lista completa de canales y cómo construir una cadena de escalada simple en cómo recibir alertas de HostTracker. Para saber qué comprueba HostTracker antes de decidir que tu sitio está caído, consulta las funciones de HostTracker y la monitorización de disponibilidad distribuida.

• Todas las guías de monitorización: el punto central para cada tipo de comprobación que puede publicar en Slack.
• ¿El sitio web está caído para todo el mundo o solo para mí?: qué hacer primero cuando llega un mensaje Down al canal.
• Funciones de HostTracker
• Monitorización de disponibilidad distribuida
• Cómo recibir alertas de HostTracker