Puesta en marcha y configuración - Discord
Qué envía esta integración
La integración con Discord es una función del panel de DockRay: el canal de notificaciones publica en un canal de Discord 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 del mismo servidor de Discord.
Preparación en Discord
- Crea una aplicación en el Discord Developer Portal y añádele un bot.
- Copia el token del bot desde la pestaña Bot.
- Invita al bot a tu servidor con un enlace OAuth2 que incluya el scope
bot. - Concédele View Channel, Send Messages y Embed Links en los canales donde deban aparecer las alertas.
- Copia el ID de cada canal de destino (modo desarrollador de Discord → clic derecho sobre el canal → Copiar ID de canal).
DockRay identifica un canal únicamente por su ID numérico, nunca por el nombre - Discord permite dos canales con el mismo nombre en un servidor, así que el nombre no sería inequívoco.
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 Discord y pega el token del bot.
- Para cada tipo de evento, indica el ID del canal: una cadena de 17 a 20 dígitos; cualquier otro formato se rechaza de inmediato.
- Guarda. Dejar el campo del token vacío al guardar significa 'mantener lo guardado'.
Un proyecto hereda por defecto la configuración de la cuenta y puede sobrescribirla con su propio bot y canales, 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. Solo funciona cuando el token está guardado o recién introducido y el campo del canal contiene un ID válido. Una prueba correcta confirma además que el bot tiene realmente permiso para publicar en el canal de destino, no solo que el token es válido.