Guía de Administrador - CS Monitor

¡Bienvenido, SysAdmin! Esta guía te ayudará a desplegar el Backend de CS Monitor en tu servidor y configurar la App Móvil en tu dispositivo.

🏗️ Fase 1: Despliegue del Backend

Debes instalar la API en un servidor (VPS) accesible desde internet (o VPN). Esta API actúa como puente entre tu celular y tus servidores gestionados.

1. Requisitos Previos

Asegúrate de que tu servidor tenga Docker y Docker Compose instalados. * Verificación: Ejecuta docker --version y docker-compose --version.

2. Pasos de Instalación

1. Subir: Sube la carpeta backend incluida en este zip a tu servidor (usando SCP o FileZilla).

2. Navegar: Entra a la carpeta vía SSH.

   cd backend
   

3. Iniciar: Ejecuta el siguiente comando para construir e iniciar el contenedor.

   sudo docker-compose up -d --build
   

4. Crear Usuario Admin: Necesitas un superusuario para loguearte en la App.

   sudo docker-compose exec cs-monitor-backend python manage.py createsuperuser
   

   (Sigue las instrucciones para elegir usuario y contraseña).

✅ ¡Éxito! Tu backend está corriendo en: http://ip-de-tu-servidor:8000

📱 Fase 2: Configuración Móvil

1. Instalar la App

• Android: Transfiere el archivo .apk a tu celular e instálalo.
• iOS: Nota: El archivo IPA debe ser compilado manualmente con Xcode debido a restricciones de Apple.

2. Primer Inicio de Sesión

1. Abre CS Monitor.
2. Server URL: Ingresa la dirección de tu backend (ej: http://192.168.1.50:8000).
3. Credenciales: Usa el usuario/contraseña que creaste en la Fase 1 (Paso 4).

🔐 Seguridad: Al entrar, la app te pedirá activar Biometría (Huella/Cara). Recomendamos activarlo para un acceso rápido y seguro.

⚙️ Fase 3: Agregar tu Primer Servidor

1. Ve al Menú (⋮) > Server Admin.
2. Toca el botón flotante (+).

Campos de Configuración

• Nombre: Un nombre para identificarlo (ej: "Producción Web").
• Local Server: Déjalo desactivado (a menos que monitorees el mismo servidor del backend).
• Host/IP: La IP del servidor objetivo.
• Puerto: Usualmente 22.
• Usuario SSH: ej: root.
• Autenticación: Elige Contraseña o Llave Privada.
• Modo Mantenimiento (Opcional):
  • Actívalo si quieres controlar una página de mantenimiento remota.
  • Comando: Ruta del script (ej: /root/scripts/toggle_maintenance.sh).

4. Toca Guardar.

📊 Usando el Dashboard

Vuelve al Home y selecciona tu servidor.

1. Recursos

Verás gráficos en tiempo real de CPU, RAM y Disco.

2. Gestión de Servicios

Para monitorear servicios (como Nginx o Docker): 1. Toca el botón Configurar Recursos (icono de lista junto al servidor en Server List) o desde la pestaña de Servicios si está vacío. 2. Etiqueta: "Servidor Web". 3. Nombre Real: nginx (Debe coincidir con systemd). 4. Protegido: Márcalo para evitar detener el servicio por error.

3. Visor de Logs

1. Ve al Menú > Logs Viewer.
2. Selecciona el log.
   • Tipo Archivo: Para archivos estándar (ej: /var/log/syslog).
   • Tipo Journal: Para logs de servicios (ej: Servicio ssh).

❓ Solución de Problemas

P: Error de conexión al loguearme. R: Verifica que el puerto 8000 esté abierto en el firewall de tu servidor (AWS Security Groups / UFW).

P: Falla la conexión SSH. R: Verifica si tu servidor permite autenticación por contraseña o si la llave privada es correcta.

P: Los datos no cargan. R: Desliza hacia abajo (Pull-to-refresh) para actualizar los datos.

¡Gracias por usar CS Monitor!