Puesta en marcha y configuración - Slack
Qué envía esta integración
La integración con Slack es una función del propio panel de DockRay, no algo que se instale en el lado del cliente. El canal de notificaciones publica en los canales de Slack elegidos cuando el programador o el flujo de ingesta detecta uno de cinco eventos de monitorización:
- ping: el servidor de la aplicación deja de responder,
- ssl: el certificado está a punto de caducar,
- google-page-speed: una caída de rendimiento,
- issue: un error nuevo, nunca visto antes,
- error-spike: un aumento repentino del número de errores.
Cada tipo de evento tiene su propio interruptor y puede ir a su propio canal: las incidencias de disponibilidad al canal de guardia, el rendimiento a quien se encarga del mantenimiento.
Preparación en Slack
- Crea una app de Slack en tu workspace (api.slack.com/apps).
- En OAuth & Permissions, añade al bot el scope
chat:write. - Instala la app en el workspace y copia el Bot User OAuth Token, que empieza por
xoxb-. - Invita al bot a los canales donde deben llegar las alertas: siempre en los privados, y también en los públicos si el bot no puede unirse a ellos por sí mismo.
DockRay rechaza un token sin el prefijo xoxb- ya al guardar el formulario - el error más habitual en este paso es pegar un token de usuario (xoxp-) o uno de firma (xoxs-) en lugar del token del bot.
Configuración en el panel de DockRay
Hay una pantalla para la cuenta y otra para el proyecto: Ajustes → Canales de notificación, y para un proyecto concreto, Ajustes del proyecto → Canales de notificación. Editarla requiere el permiso de gestión de proyectos, que tienen el rol developer y los superiores.
- Activa el proveedor Slack y pega el token del bot.
- Para cada tipo de evento, indica un canal: un nombre (por ejemplo
#alertas) o un ID de canal. - Guarda. Dejar el campo del token vacío al guardar significa 'mantener lo guardado' - la credencial nunca vuelve al formulario en texto plano.
Un proyecto hereda por defecto la configuración de la cuenta. También puede sobrescribirla con su propio token y sus propios canales, o desactivar explícitamente un tipo de evento concreto, con independencia de lo que tenga configurado la cuenta.
El mensaje de prueba
Cada tipo de evento tiene un botón Enviar prueba. Publica un mensaje de ejemplo por el mismo camino que seguiría una alerta real; solo funciona cuando todo está completo: un token guardado o recién introducido y un canal indicado. La prueba confirma así no solo que el token es válido, sino que el bot es realmente visible en el canal de destino.