Documentación
Monitoreo
Activa el sondeo para cada VM, comprende las métricas recopiladas y consulta el comando exacto de la sonda.
El monitoreo aquí es sin agente: no se instala nada en los servidores, no se abren puertos adicionales. La aplicación mantiene una conexión SSH por cada VM monitoreada y ejecuta exactamente un comando de solo lectura por ciclo de sondeo.
Activar para una VM
Abre la pestaña Monitoreo de la VM, luego:
- Activa el interruptor Activar.
- Elige la credencial que se usará para el sondeo — debería ser una cuenta de bajos privilegios, consulta Credenciales.
- Establece el intervalo (segundos). 60 segundos es un equilibrio razonable para la mayoría de los casos.
El sondeo comienza en unos 15 segundos — una tarea de monitoreo en segundo plano revisa periódicamente qué VMs están activadas y las asocia con tareas en ejecución. Desactivarlo detiene la tarea en el mismo plazo.
El botón Sondear ahora ejecuta un ciclo inmediato sin esperar al siguiente programado.
Bóveda bloqueada significa que el monitoreo se detiene
El sondeo necesita credenciales, y las credenciales viven en la bóveda. Así que:
- Bloquear bóveda → todas las tareas de sondeo se detienen.
- Desbloquear bóveda → las tareas se reinician automáticamente.
- Bloquear pantalla → sin efecto, el sondeo continúa con normalidad.
Métricas recopiladas
| Grupo | Contenido |
|---|---|
| Carga del sistema | Tiempo de actividad, promedio de carga de 1 minuto, porcentaje de CPU |
| Memoria | RAM usada/total, swap usada/total |
| Disco | Por punto de montaje: usado, total, porcentaje |
| Red | Tasa de recepción/transmisión en bytes por segundo |
| Procesos | Los seis principales consumidores de CPU |
| Seguridad | Puertos en escucha, cuentas, claves SSH autorizadas, sudoers, registro de inicio de sesión |
El porcentaje de CPU y la tasa de red se derivan entre sondeos consecutivos — así que el primer sondeo tras activar el monitoreo no tendrá estos dos valores.
Historial y retención
- Las muestras sin procesar se conservan 14 días, y luego se eliminan.
- Mientras tanto, los datos se agregan en resúmenes diarios y se conservan a largo plazo. Los informes mensuales leen de esta tabla de resúmenes, no de las muestras sin procesar — si leyeran las muestras, un “informe mensual” incluiría silenciosamente solo dos semanas.
La pestaña de monitoreo dibuja gráficos a partir de la ventana de 14 días de muestras sin procesar.
Cuando el servidor no responde
Un sondeo fallido es normal. Dos fallos consecutivos marcan la VM como inaccesible y crean un evento.
Después de cada fallo, el intervalo de sondeo se incrementa gradualmente (máximo 5 minutos) para evitar saturar una máquina caída. Cuando se recupera, el intervalo vuelve a la normalidad y se registra un evento de recuperación.
Comando de sondeo
Esto es lo que necesitarás cuando el cliente pregunte “qué ejecuta su software en nuestro servidor”. El comando es una constante en el código fuente, nunca se ensambla a partir de datos del usuario, y la aplicación lo muestra textualmente (botón Ver comando de sondeo en la pestaña de monitoreo).
LC_ALL=C; export LC_ALL
echo '@@VMOPS:uptime@@'; cat /proc/uptime
echo '@@VMOPS:load@@'; cat /proc/loadavg
echo '@@VMOPS:cpu@@'; grep '^cpu ' /proc/stat
echo '@@VMOPS:mem@@'; grep -E '^(MemTotal|MemFree|MemAvailable|Buffers|Cached|SwapTotal|SwapFree):' /proc/meminfo
echo '@@VMOPS:net@@'; cat /proc/net/dev
echo '@@VMOPS:disk@@'; df -P -k
echo '@@VMOPS:procs@@'; ps -eo pcpu,pmem,comm --sort=-pcpu | head -6
echo '@@VMOPS:ports@@'; ss -H -tuln || netstat -tuln
echo '@@VMOPS:users@@'; cut -d: -f1,3,7 /etc/passwd
echo '@@VMOPS:keys@@'; # readable authorized_keys file contents
echo '@@VMOPS:sudoers@@'; cat /etc/sudoers /etc/sudoers.d/*
echo '@@VMOPS:auth@@'; journalctl -u sshd # or /var/log/auth.log
echo '@@VMOPS:fail2ban@@'; fail2ban-client status sshd
echo '@@VMOPS:end@@'
Cuatro principios detrás de este diseño:
Un solo viaje de ida y vuelta. Cada sondeo es exactamente un sh -c que devuelve un único bloque
delimitado. Monitorear 30 máquinas por minuto no debe significar 300 canales de ejecución.
Leer /proc, no top. La salida de top, vmstat y free cambia entre
distribuciones y configuraciones regionales; /proc no.
Fijo y auditable. El comando nunca se ensambla a partir de datos de entrada — no hay superficie para inyección de comandos, y su contenido siempre se puede inspeccionar.
Degradar, nunca romper. Todo lo que necesite root y no esté disponible vuelve vacío, y el resto del sondeo igual se completa.