Documentación
Proyectos y VMs
Organiza la infraestructura por cliente en lugar de una lista plana de hosts.
Proyectos
Un proyecto es la unidad organizativa de nivel superior. En el modelo típico de agencia o MSP, normalmente representa a un cliente.
Crea un proyecto con el botón + al inicio de la barra lateral. Cada proyecto tiene:
- Nombre — se muestra en la barra lateral y en la parte superior de los informes mensuales.
- Color — punto de color a la izquierda, ayuda a reconocerlo de un vistazo incluso en una lista larga.
Cambia el nombre o el color en cualquier momento mediante el menú contextual del proyecto.
Eliminar un proyecto también elimina sus VMs, junto con sus credenciales e historial de monitoreo. Esta acción no se puede deshacer.
VMs
Cada VM pertenece exactamente a un proyecto y tiene estos campos:
| Campo | Significado |
|---|---|
| Nombre | Etiqueta visible. Debería reflejar el rol (web-01, db-primary) en lugar de la IP. |
| Host | Dirección IP o nombre de dominio para la conexión. |
| Puerto | Puerto SSH, por defecto 22. |
| Etiqueta | Etiquetas libres para filtrar y buscar. |
| Última conexión | Se actualiza automáticamente cada vez que abres una sesión. |
Usar etiquetas eficazmente
Las etiquetas solo ayudan si sigues una convención. Algunos conjuntos comunes:
- Por entorno:
prod,staging,dev - Por rol:
web,db,cache,mail - Por prioridad:
critical,sla-24h
Con la paleta de comandos (Ctrl+K), escribe una etiqueta para filtrar ese grupo de máquinas — más rápido que desplazarse por la barra lateral.
Barra lateral
La barra lateral muestra los proyectos como un árbol, que se expande a listas de VMs. Para cada VM puedes:
- Doble clic — abre una pestaña de terminal.
- Menú contextual — abrir SFTP, abrir pestaña de monitoreo, editar, administrar credenciales, eliminar.
El punto junto al nombre de una VM refleja el sondeo de monitoreo más reciente, no el estado de la sesión SSH:
| Color | Significado |
|---|---|
| Verde | El último sondeo tuvo éxito. |
| Amarillo | Se está superando un umbral (disco, RAM, CPU). |
| Rojo | Dos sondeos consecutivos fallaron — la VM se considera inaccesible. |
| Gris | El monitoreo no está activado para esta VM. |
Resumen general
La pantalla de Resumen general agrupa todos los proyectos: cuántas VMs están monitoreadas, cuántas alertas sin confirmar hay y qué máquinas tienen problemas. Este es el primer lugar a revisar cada mañana — antes de abrir cualquier terminal.
Importación masiva
Si estás migrando desde otra herramienta, no escribas todo a mano. Consulta Importar desde ~/.ssh/config: la aplicación lee tu archivo de configuración de OpenSSH existente y te permite marcar los hosts que quieres traer a un proyecto.