Puesta en marcha y configuración - Mattermost
Qué envía esta integración
La integración con Mattermost es una función del panel de DockRay: el canal de notificaciones publica en un canal de Mattermost elegido 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 un canal distinto.
Preparación en Mattermost
- Pide al administrador de tu servidor Mattermost que active los Incoming Webhooks, si aún no lo están.
- Crea un nuevo webhook entrante para el canal al que deben llegar las alertas.
- Copia la dirección generada: una URL HTTPS completa que termina en un identificador aleatorio.
La dirección del webhook debe ser HTTPS pública; si no, DockRay la rechaza ya al guardar. No es una limitación propia de Mattermost, sino una condición que DockRay exige a cualquier dirección introducida en el panel - ver la sección de validación en el siguiente artículo.
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 Mattermost y pega la dirección del webhook.
- Para cada tipo de evento, indica un nombre de canal: Mattermost permite que un webhook publique en un canal distinto de aquel para el que se creó, si se indica explícitamente.
- Guarda. Dejar el campo de la dirección 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 y puede sobrescribirla con su propio webhook, o desactivar un tipo de evento concreto con independencia de los ajustes de 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 la dirección del webhook está guardada o recién introducida y hay un canal indicado. Una prueba correcta confirma que la dirección sigue activa del lado de Mattermost - los webhooks se eliminan a veces al hacer limpieza de integraciones.