Documentación

Alertas en Slack: envía las alertas de Pingsured a un canal

Pingsured puede publicar una alerta en un canal de Slack cuando un ping empieza a fallar, cuando se recupera y cuando se cambia su certificado. Es un webhook que habla Slack: usted da a Pingsured la URL de un webhook de Slack y cada alerta llega a ese canal como un mensaje legible. Las alertas en Slack están disponibles en los mismos planes que los webhooks, es decir, todos los planes de pago. Las configura un propietario o un gestor de la cuenta, para un solo ping o como valor predeterminado de todos los pings de la cuenta.

Qué necesitas

  • Un espacio de trabajo de Slack en el que pueda añadir una app, o un administrador que la apruebe.
  • El canal al que deben ir las alertas. Un webhook publica en un solo canal; para avisar a un segundo canal, cree un segundo webhook.

Crear el webhook en Slack

Cree el webhook desde una app de Slack, no desde la antigua integración «Incoming WebHooks» del directorio de apps de Slack. Slack ya no la recomienda y puede retirarla.

  • Abra api.slack.com/apps y elija Create New App, luego From scratch. Póngale un nombre, por ejemplo Pingsured, y elija su espacio de trabajo.
  • En los ajustes de la app abra Incoming Webhooks y actívelo.
  • Elija Add New Webhook to Workspace, seleccione el canal y permita el acceso.
  • Copie la Webhook URL. Empieza por https://hooks.slack.com/services/.

Trate la URL como un secreto: quien la tenga puede publicar en ese canal. Pingsured la muestra completa solo a propietarios y gestores.

Añadirlo en Pingsured

  • Para todos los pings, abra Configuración → Notificaciones, vaya a Integraciones en Notificaciones predeterminadas y elija la tarjeta Slack.
  • Para un ping, abra el ping, vaya a su sección Notificaciones, elija Añadir suscripción y luego Slack.

Pegue la URL del webhook. Pingsured solo acepta direcciones de Slack, así que la URL de otro servicio se rechaza al guardar. Después elija los disparadores. Lo recomendado es Primer error y Primer OK, más Certificado cambiado si comprueba certificados: se entera cuando algo falla y cuando se arregla.

Con Enviar prueba, junto al canal, se publica un mensaje marcado como prueba. Es la forma más rápida de comprobar que la URL y el canal son correctos antes de que una alerta dependa de ellos.

Cómo es un mensaje

  • Un titular con el nombre del ping y un punto de color: rojo si falla, amarillo si está degradado, verde cuando se ha recuperado.
  • El motivo, si lo hay: el estado HTTP, el error o por qué falló una comprobación de contenido.
  • Dónde se vio: la ubicación, como Desde de, o, en un ping comprobado desde varias, cuáles fallan, como Fallando desde de, sg (2 de 3 ubicaciones).
  • Un enlace, Ver ping en Pingsured, que abre el ping.

Un cambio de certificado dice Certificado cambiado en el ping, o Certificado inesperado en él cuando el cambio no parece una renovación, con los motivos debajo.

El idioma de los mensajes

Los mensajes se escriben en el idioma de las notificaciones de la cuenta, que un propietario fija en Configuración → Cuenta. Hay mensajes en inglés, alemán, español, francés e italiano. Mientras no se fije, van en inglés. El mismo ajuste es el idioma de reserva de los correos de alerta a miembros que no han elegido uno propio. La línea del motivo se muestra tal como la informó el servicio comprobado, en el idioma que fuera.

Cuándo se envían los mensajes

Un canal de Slack sigue las mismas reglas que cualquier otro canal de alertas: qué cambios, cuántos fallos primero, con qué frecuencia y desde dónde se describen en la página de notificaciones. Un cambio de estado se envía siempre al instante, y las alertas repetidas del mismo ping y canal se retienen 15 minutos.

Si un mensaje no llega

Cuando no se puede contactar con Slack o responde con un error que puede pasar, el envío se reintenta, 5 intentos en total, con 30 segundos, 5 minutos, 30 minutos y 2 horas de diferencia. Cualquier otra respuesta de Slack es definitiva. Slack responde con un motivo breve, por ejemplo no_service cuando el webhook se eliminó o channel_is_archived cuando el canal se archivó, y Pingsured muestra lo que dijo Slack al pasar el ratón por la insignia de estado junto al canal en Configuración → Notificaciones. Lo habitual es crear un webhook nuevo: créelo en la app de Slack, añádalo en Pingsured y elimine el antiguo.

Límites

  • Los canales de Slack cuentan junto con los webhooks para los mismos límites: 50 en toda la cuenta y 20 en un ping.
  • Los mensajes van al canal para el que se creó el webhook. Las menciones, los mensajes directos y los hilos aún no están disponibles.