No puedo iniciar sesión

• Mensaje «credenciales inválidas»: el correo no existe o la contraseña no coincide. Utilizar la opción ¿olvidaste tu contraseña? para recuperarla.
• Mensaje «demasiados intentos»: Firebase Authentication bloquea temporalmente la cuenta tras varios intentos fallidos. Esperar entre cinco y quince minutos antes de reintentar.
• Sesión expirada repetidamente: la cookie auditx_session tiene vencimiento de una hora; tras ese plazo, la próxima petición redirige a /login. Si esto ocurre cada pocos minutos, revisar que el reloj del sistema esté sincronizado y que las cookies estén habilitadas para el dominio.

El servidor aparece como «Error» o «Inactivo»

• Error de autenticación SSH: revisar usuario y contraseña/clave desde el botón editar de la tarjeta. Recordar que las claves deben estar en formato OpenSSH/PEM, no PuTTY (.ppk).
• Timeout / host no accesible: confirmar que el servidor responde a un ping desde otra máquina y que el puerto SSH (típicamente 22) está abierto en el firewall.
• Llave SSH con passphrase: si la clave privada está protegida, debe ingresarse la passphrase en el campo correspondiente; el backend no puede adivinarla.

Las métricas se ven en cero o no actualizan

• Presionar refrescar para forzar una lectura inmediata.
• Verificar que el usuario SSH configurado tenga permisos para uptime, df, free y top.
• En sistemas mínimos (contenedores, BSD) es posible que top -bn1 no funcione tal cual; revisar los logs del backend para identificar la línea que falla.

El terminal SSH no abre o se desconecta

• Confirmar que el navegador soporta WebSocket sin proxy intermedio.
• Tras treinta minutos sin actividad, la conexión se cierra automáticamente por el idle timeout configurado en el backend. Recargar la pantalla del terminal lo reabre.
• Si la consola muestra caracteres extraños, verificar que la variable LANG del servidor remoto esté en UTF-8.

No recibo notificaciones de escritorio

• Revisar el conmutador desktop en Perfil → Preferencias de notificación.
• Confirmar que el navegador concedió permiso para notificaciones de este sitio. En macOS, además, el Centro de Notificaciones debe permitir alertas del navegador.
• Asegurar que la severidad mínima configurada (level) incluye la severidad de las alertas recibidas. Por ejemplo, si level=critical, las warnings no dispararán notificación.
• Tras un cambio de cuenta, la primera lectura del histórico no dispara notificaciones para evitar inundar al usuario; solo las nuevas alertas tras esa lectura disparan.

Una regla de comando no se evalúa

• Verificar que la salida del comando es numérica. Si el comando devuelve texto, el motor no puede compararlo y omite la regla.
• Probar el comando directamente desde el terminal integrado para confirmar el formato exacto de la salida.
• Para extraer un número de una salida más larga, encadenar con awk, grep -oE, wc -l, etc.

No puedo agregar más servidores

El plan free permite hasta dos servidores. Para superar ese límite es necesario migrar al plan pro desde la sección Billing.

El navegador muestra una pantalla en blanco al entrar al dashboard

• Limpiar caché del sitio y recargar.
• Confirmar que las cookies de terceros no están bloqueadas para el dominio.
• Si el problema persiste, abrir las herramientas de desarrollador (F12) en la pestaña Console y reportar el primer error que aparezca al soporte.

Contacto y soporte

Para reportar incidencias no cubiertas en este manual, escribir a perezdavilaalejandro2@gmail.com indicando la sección donde ocurrió el problema, los pasos para reproducirlo y, si es posible, una captura de pantalla.