Canales de aviso
Un canal es por dónde llegan los avisos de las alertas: una notificación de ntfy en el móvil, un mensaje de Telegram, un mensaje en una sala de Matrix o un correo. Se configuran en el menú Canales (solo administradores) y se pueden tener varios a la vez.
Cada canal indica de qué avisa (avisos y críticos, o solo críticos) y si avisa también de las recuperaciones. Tras guardarlo, el botón Probar envía un mensaje de prueba; la columna Último envío dice si llegó o el error que dio.
Las contraseñas y tokens se guardan cifrados con la clave maestra del servidor (/etc/atalaya/master.key). Al editar un canal aparecen como ********: si no los tocas, se conservan.
ntfy
ntfy envía notificaciones al móvil con una app gratuita para Android e iOS, sin cuentas ni teléfono. Es el más sencillo.
- Instala la app de ntfy en el móvil.
- Inventa un tema difícil de adivinar, por ejemplo
atalaya-casa-x7k2p9, y suscríbete a él en la app. - En Atalaya, añade un canal ntfy con el servidor
https://ntfy.shy ese tema, y pulsa Probar.
Con ntfy.sh, cualquiera que conozca el tema puede leer los avisos: no uses uno obvio. Si tienes tu propio servidor ntfy, pon su dirección y, si lo exige, un token de acceso. Los críticos llegan con prioridad máxima; los avisos, con prioridad alta.
Telegram
- En Telegram, habla con @BotFather, envía
/newboty sigue los pasos: al final te da el token del bot. - Abre un chat con tu bot nuevo y envíale cualquier mensaje.
- Para saber tu chat ID, abre en el navegador
https://api.telegram.org/bot<TOKEN>/getUpdates(con tu token) y busca"chat":{"id":…}. - En Atalaya, añade un canal Telegram con el token y el chat ID, y pulsa Probar.
Para avisar a un grupo, añade el bot al grupo y usa el chat ID del grupo (empieza por -).
Matrix
- Crea un usuario para Atalaya en tu servidor Matrix (o usa una cuenta tuya) e invítalo a la sala donde quieras los avisos; acepta la invitación.
- Obtén su token de acceso: en Element, Ajustes → Ayuda y acerca de → Avanzado → Token de acceso (al cerrar esa sesión el token deja de valer; mejor iniciar sesión con el bot en una sesión aparte).
- Copia el ID interno de la sala (Ajustes de la sala → Avanzado), que empieza por
!; un alias como#sala:servidorno sirve. - En Atalaya, añade un canal Matrix con la dirección del servidor (
https://matrix.ejemplo.es), el ID de la sala y el token, y pulsa Probar.
Las salas con cifrado de extremo a extremo no sirven: Atalaya envía el mensaje en claro y esas salas lo rechazan o no lo muestran. Usa una sala sin cifrar.
Correo
Hay dos formas de enviar los avisos por correo:
- Correo del sistema. Atalaya entrega el aviso al servidor de correo del propio equipo (postfix, exim, nullmailer…) y este lo envía como esté configurado; no hay que dar usuario ni contraseña. Solo hace falta el destinatario; el remitente es opcional (por defecto,
atalaya@<nombre del equipo>). Es lo más cómodo si el equipo ya sabe enviar correo, por ejemplo con postfix configurado para reenviar por el servidor de correo de casa (relayhost). - Servidor SMTP. Atalaya se conecta él mismo a un servidor de correo con usuario y contraseña. Indica el servidor como
smtp://servidor:587(con STARTTLS) osmtps://servidor:465, el usuario y la contraseña, el remitente y uno o varios destinatarios separados por comas. La conexión va siempre cifrada. Con Gmail u otros proveedores con verificación en dos pasos, usa una contraseña de aplicación, no la de la cuenta.
Con el correo del sistema, que Probar diga «entregado» significa que el servidor de correo local lo ha aceptado; si luego no llega, mira su registro (journalctl -u postfix o /var/log/mail.log). Un postfix sin relayhost intenta entregar directamente y muchos proveedores rechazan el correo que sale de una conexión doméstica.
Resumen semanal
Además de los avisos, Atalaya puede mandar un correo a la semana con el resumen: las alertas abiertas y las de los últimos 7 días, los equipos con más alertas, la disponibilidad más baja, las caducidades de certificados y dominios próximas, los discos que se llenarán pronto y los equipos nuevos descubiertos. Se activa en Ajustes → Avisos (Resumen semanal por correo), con el día y la hora que quieras (la hora, en la zona horaria del servidor), y llega por todos los canales de correo activos, sin importar su gravedad mínima. Enviar resumen ahora, en esta pantalla, lo manda en el momento para ver cómo queda.
Si no llega
- Mira la columna Último envío y pasa el ratón por encima para ver el error.
- El servidor de Atalaya necesita salida a internet hacia el servicio (ntfy.sh, api.telegram.org, tu servidor Matrix o tu servidor de correo).
- En el registro del servidor (
journalctl -u atalaya) aparece cada envío fallido con su motivo.