Cómo instalar OmniSight en Docker - Dashboard de monitoreo unificado autohospedado en Docker

OmniSight | Monitoring Dashboard | Docker

OmniSight: Dashboard de monitoreo unificado autohospedado en Docker para infraestructura diversa (alternativa Grafana, Zabbix)

Dashboard ligero unificado para Proxmox, Linux/Windows, Kubernetes, Docker, SNMP, firewalls, bases de datos. Cards drag-and-drop. Métricas real-time. Históricos. Logs vivos. Controles servicios. Alertas ntfy/Telegram/SMTP. Agentes push sin puertos abiertos. Go ultralligero. MIT open source.

¿Qué es OmniSight?

Omnisight Logo

OmniSight es un dashboard de monitoreo unificado y ligero diseñado para proporcionar una vista centralizada de infraestructura diversa (servidores, containers, servicios) con interfaz moderna drag-and-drop, sin necesidad de configuración compleja como Grafana o Zabbix. Es ideal para homelabs y pequeñas infraestructuras que buscan visibilidad simple pero potente.

Propuesta clave: Dashboard unificado para múltiples fuentes (Proxmox, Linux, Windows, Kubernetes, Docker, SNMP, firewalls, DBs). Cards draggable (reorganiza tu dashboard). Métricas real-time con históricos. Live logs integrados. Controles servicios directo (restart, stop). Alertas via ntfy/Telegram/SMTP. Agentes push para monitoreo sin abrir puertos inbound (pull-based). Interfaz responsive moderna (mobile-friendly). Ligero en Go. Deploy simple (un comando). Autenticación integrada. Soporte múltiples agentes (Linux, Windows, Kubernetes).

Características principales: Dashboard unificado (vista centralizada multi-infraestructura). Cards draggable (organiza tu vista). Métricas real-time (CPU, RAM, disco, red). Históricos gráficos (tendencias). Live logs integrados (sin buscar en otro lado). Controles servicios (start/stop/restart). Status servicios (uptime, health checks). Alertas (ntfy, Telegram, SMTP, email). Agentes push (comunican al servidor, sin puertos abiertos). Integración Uptime Kuma, Prometheus, Healthchecks. Soporta Proxmox, Linux (agent), Windows (agent), Kubernetes, Docker, SNMP devices, firewalls. Autenticación (login). BD SQLite local. API REST. Configuración YAML/JSON. Tema claro/oscuro. Responsive (desktop, tablet, mobile). Ligero (escrito Go). Container Docker one-liner. MIT open source.

Para homelabs: Dashboard unificado simple. Múltiples fuentes en una vista. Sin complejidad Grafana. Drag-and-drop. Alertas integradas.

Características principales

Dashboard unificado drag-drop

Cards reorganizables. Múltiples fuentes en una vista. Personalizable.

Métricas real-time + históricos

CPU, RAM, disco, red. Gráficos históricos. Tendencias visuales.

Live logs integrados

Logs en tiempo real. Sin salir dashboard. Correlación eventos.

Controles servicios

Start, stop, restart servicios. Control directo desde dashboard.

Alertas múltiples canales

ntfy, Telegram, SMTP, email. Notificaciones instant.

Agentes push (sin puertos abiertos)

Agentes comunican al servidor. Seguro. Firewall-friendly.

Multi-infraestructura

Proxmox, Linux, Windows, Kubernetes, Docker, SNMP, firewalls, DBs.

Integraciones externas

Uptime Kuma, Prometheus, Healthchecks. Datos de cualquier fuente.

Autenticación integrada

Login. Control acceso. Multi-usuario capable.

Tema claro/oscuro responsive

UI moderna. Mobile-friendly. Accesible tablets, móviles.

Ligero en Go

Ultra-eficiente. Bajo RAM. Bajo CPU. Rápido.

MIT open source

Código abierto. Extensible. Comunidad activa.

Requisitos del sistema

  • Docker (para correr OmniSight container)
  • 50 MB - 200 MB RAM (muy ligero, Go)
  • 100 MB espacio disco mínimo (para imagen + BD SQLite)
  • Puerto 3000 o custom (configurable en env)
  • Volumen persistente para /app/data (BD, config)
  • OMNISIGHT_SECRET env var (para encriptación tokens/auth)
  • NET_RAW capability (para SNMP/network features)
  • Navegador moderno (Chrome, Firefox, Safari, Edge)
  • Agentes opcionales: Linux agent, Windows agent, Kubernetes, etc.
Setup ultra-simple: Docker one-liner. 1 minuto a monitoreo unificado.

Instalación con Docker Compose

Opción 1: Docker Compose básico (recomendado)

cat > docker-compose.yml << 'EOF' version: '3.8' services: omnisight: image: ghcr.io/caglaryalcin/omnisight:latest container_name: omnisight restart: unless-stopped ports: - "3000:3000" cap_add: - NET_RAW environment: # Puerto donde corre OmniSight - PORT=3000 # Timezone - TZ=Europe/Madrid # Secret key para encriptación (generar con: openssl rand -base64 32) - OMNISIGHT_SECRET=tu_secret_key_generado_aqui volumes: # Persistencia: BD, config, datos - omnisight_data:/app/data healthcheck: test: ["CMD", "wget", "--quiet", "--tries=1", "--spider", "http://localhost:3000"] interval: 30s timeout: 5s retries: 3 volumes: omnisight_data: EOF docker compose up -d

Opción 2: Generar SECRET key seguro

openssl rand -base64 32 # Copia el resultado y úsalo como OMNISIGHT_SECRET en docker-compose

Opción 3: Docker run simple

docker run -d \ --name omnisight \ --restart unless-stopped \ -p 3000:3000 \ --cap-add NET_RAW \ -e PORT=3000 \ -e TZ=Europe/Madrid \ -e OMNISIGHT_SECRET=tu_secret_key_aqui \ -v omnisight_data:/app/data \ ghcr.io/caglaryalcin/omnisight:latest

Acceder (setup inicial)

http://localhost:3000 - Dashboard OmniSight (setup wizard)

Primer setup (2 minutos)

  1. Abre http://localhost:3000
  2. Setup wizard: crea usuario admin, contraseña
  3. Login con credenciales
  4. Dashboard aparece (vacío, listo agregar monitoreos)
  5. Agregar agents/servicios a monitorear

Primeros pasos

1. Setup inicial (wizard)

  1. Abre http://localhost:3000
  2. Setup: nombre usuario, password admin
  3. Login
  4. ¡Dashboard listo!

2. Agregar agente Linux

  1. Dashboard → "Add Agent" o "Add Monitoring"
  2. Tipo: "Linux Agent"
  3. Nombre, descripción
  4. Copia comando instalación (one-liner)
  5. Ejecuta en servidor Linux que quieres monitorear
  6. Agent se conecta automático (push-based)

3. Agregar Docker container

  1. Dashboard → "Add Monitoring" → "Docker"
  2. URL Docker socket (localhost/remoto)
  3. OmniSight auto-detecta containers
  4. Agregalos a dashboard

4. Agregar Proxmox/Hypervisor

  1. Dashboard → "Add Monitoring" → "Proxmox"
  2. Hostname Proxmox, usuario, contraseña/token
  3. OmniSight automáticamente monitorea VMs y contenedores LXC

5. Ver métricas real-time

  1. Cada card muestra: CPU %, RAM %, Disco, Network
  2. Actualización cada 5-10 segundos (configurable)
  3. Click card → detalles expandido + histórico

6. Ver históricos gráficos

  1. Card → "History" o "Charts"
  2. Gráficos mostrando tendencias (últimas horas/días)
  3. Zoom, pan, filtrar tiempo

7. Ver logs vivos

  1. Card → "Logs" tab
  2. Logs streaming en vivo (tail -f style)
  3. Búsqueda y filtro instant

8. Configurar alertas Telegram

  1. Settings (engranaje) → "Notifications" o "Alerts"
  2. Tipo: Telegram
  3. Bot token + chat ID
  4. Rules: CPU >80%, RAM full, disk space, etc
  5. Recibe alertas instant en Telegram

9. Reorganizar cards (drag-and-drop)

  1. Click "Edit Dashboard" o modo edición
  2. Arrastra cards a nueva posición
  3. Redimensiona si soporta
  4. Click "Save" o auto-saves

10. Agregar servicio externo (Uptime Kuma)

  1. Dashboard → "Add Monitoring" → "Uptime Kuma"
  2. URL Uptime Kuma
  3. OmniSight fetchea estado de monitores

11. Controles servicios (start/stop)

  1. Card servicio → botones Start/Stop/Restart
  2. Controla servicios directamente desde dashboard
  3. Requiere permisos agent en servidor remoto

12. Tema oscuro/claro

  1. Settings → Theme
  2. Dark/Light/Auto (sigue sistema operativo)
  3. Preferencia guardada

Casos de uso

  • Homelabs: Monitoreo unificado múltiples máquinas/servicios. Dashboard centralizada. Simple pero potente.
  • Pequeñas infraestructuras: Servidores físicos + VMs + containers. Una vista de todo.
  • Multi-cloud: Proxmox + AWS + Azure. Agregación centralizada.
  • Monitoreo seguro: Agentes push (sin abrir puertos). Firewall-friendly.
  • Alertas rápidas: Ntfy, Telegram, SMTP. Notificaciones instant.
  • Reemplazo Grafana/Zabbix: Alternativa ligera. Setup simple. Sin querydsl.

HTTPS con Caddy (producción)

Caddyfile

monitor.tudominio.com { reverse_proxy localhost:3000 }

Acceso remoto seguro

https://monitor.tudominio.com con HTTPS automático

IMPORTANTE: OmniSight incluye autenticación

Login requerido por defecto. Seguro para exposición remota si usas HTTPS + contraseña fuerte.

Gestión y mantenimiento

Ver logs

docker logs -f omnisight

Backup de data (BD + config)

docker cp omnisight:/app/data ./omnisight-backup-$(date +%Y%m%d)

Restore data

docker stop omnisight docker cp ./omnisight-backup-YYYYMMDD/data omnisight:/app/ docker start omnisight

Reiniciar container

docker compose restart omnisight

Actualizar a versión más reciente

docker compose pull docker compose up -d

Monitorear consumo

docker stats omnisight # Típicamente: <100mb bajo="" cpu="" ligero="" muy="" ram="" span="">

Cambiar puerto (si 3000 está ocupado)

cat > docker-compose.yml << 'EOF' ... environment: - PORT=8888 # Cambiar puerto aquí ports: - "8888:8888" # Y aquí EOF

Ver URL agente Linux (para instalación remota)

docker exec omnisight cat /app/config/config.yaml | grep agent-url # O desde UI: Settings → Agents → copy install command

Comparativa con alternativas

vs Grafana

OmniSight gana: Ligero, simple, setup rápido, drag-drop. Grafana gana: Más queries, más plugins, más enterprise.

vs Zabbix

OmniSight gana: Ligero, interfaz moderna, agentes push simples. Zabbix gana: Maduro, más features, enterprise-ready.

vs Prometheus + Grafana

OmniSight gana: All-in-one, cero config complejos. Stack gana: Más flexible, más potente para casos complejos.

vs Netdata

OmniSight gana: Multi-infraestructura, controles servicios. Netdata gana: Per-segundo granularity, anomaly detection ML.

Mejor para: Quién necesita dashboard unificada simple para infraestructura diversa. Sin querydsl. Agentes push. Setup rápido.

Comentarios

Entradas populares de este blog

Cómo Instalar y configurar SERVIDOR VPN WIREGUARD en MIKROTIK 🔐 #VPN #Wireguard #Mikrotik #RouterOS

Cómo instalar y configurar DSM SYNOLOGY 7.2.2 en PC | Guía completa, instalación, RAID 1, SMB

Cómo INSTALAR y CONFIGURAR OpenVPN en MIKROTIK. Guía completa paso a paso.