Inventario y Diagnóstico UniFi: Auditoría Automatizada de Sitio

El Desafío
Gestionar un gran entorno UniFi a menudo implica hacer clic en múltiples sitios en la interfaz del Controlador para obtener un simple recuento de dispositivos o verificar el estado de la WAN. Para Proveedores de Servicios Gestionados (MSPs) o grandes empresas, agregar estos datos manualmente para informes es tedioso y propenso a errores.
El objetivo era recuperar instantáneamente un inventario de alto nivel para:
- Listar todos los sitios y sus IDs únicos
- Contar clientes conectados (Inalámbricos vs. Cableados)
- Verificar la salud de los enlaces ascendentes WAN
- Presentar datos en un formato administrativo limpio
El Prompt Enviado a Myrmex
Usando la integración Myrmex para UniFi, enviamos:
Conéctese al Controlador UniFi y recupere una lista completa de todos los sitios configurados.
Para cada sitio, muestre el nombre del sitio, su ID único y el número actual de dispositivos conectados.
Presente los datos en una lista clara o formato de tabla para revisión administrativa
sin realizar ningún cambio de configuración.
Nota: Myrmex abstrae la complejidad de la API de UniFi, manejando autenticación y análisis de JSON para entregar insights legibles por humanos.
Lo Que Myrmex Hizo
Myrmex se conectó al Controlador UniFi y recuperó los datos de inventario.
✅ Informe de Inventario de Sitio UniFi
La siguiente tabla proporciona la visión general administrativa de los sitios configurados y sus métricas de conexión actuales:
| Nombre del Sitio | Site ID | Clientes Conectados (Total) | Dispositivos de Infraestructura |
|---|---|---|---|
| Predeterminado (Sitio 1) | 67e5b22607d16a1beddf0193 | 550 | 95 |
| Predeterminado (Sitio 2) | 67f815a6c586ec1e33bd0cac | 440 | 83 |
Resumen Técnico y Observaciones
Basado en los metadatos recuperados durante la ejecución, aquí hay un desglose de la distribución de clientes y salud del sitio:
Sitio 1 (67e5b226...)
- Clientes Inalámbricos: 547
- Clientes Cableados: 3
- Estado de Salud: ⚠️ WAN1 está inactiva (0% uptime). El tráfico está siendo redirigido y sostenido con éxito por el enlace WAN2 (98.18% uptime), indicando que la conmutación por error está funcionando.
Sitio 2 (67f815a6...)
- Clientes Inalámbricos: 439
- Clientes Cableados: 1
- Estado de Salud: ✅ La conectividad primaria es estable vía WAN1 (98.81% uptime).
Beneficios del Enfoque
🦅 Vista Panorámica
En lugar de iniciar sesión en cada sitio individualmente, los administradores obtienen una visión consolidada de todo el parque de red en segundos.
🚨 Verificación de Failover
La auditoría destacó instantáneamente que el Sitio 1 está ejecutándose en internet de respaldo (WAN2). Sin esta verificación automatizada, TI podría no notar la falla del enlace primario hasta que el respaldo también falle.
🛡️ Seguridad No Intrusiva
La operación es estrictamente solo lectura. Usa llamadas de API (list_sites, get_health) que no modifican reglas de firewall o configuraciones de dispositivo.
Resultado
Con el análisis de Myrmex:
- ✅ Inventario Automatizado: Recuentos precisos de clientes y dispositivos recuperados para facturación/planificación de capacidad.
- ✅ Resiliencia Probada: Confirmado que la conmutación por error SD-WAN en el Sitio 1 está activa.
- ✅ Tiempo Ahorrado: Eliminada la necesidad de inicio de sesión manual y agregación manual de datos.
Variaciones del Prompt
El mismo patrón puede usarse para gestión UniFi más profunda:
Para auditoría de firmware de dispositivo:
Liste todos los Puntos de Acceso en el 'Sitio 1' que están ejecutando firmware más antiguo
que la versión 6.5.54.
Para gestión de Wi-Fi de invitados:
Genere un nuevo código de cupón Wi-Fi para la red 'Invitado' válido por
24 horas y muéstrelo aquí.
