# LibreQoS Insight
## Acerca de Insight
Conoce más sobre Insight en nuestro sitio web, [aquí](https://libreqos.io/insight/).
## Interfaz de Insight
### Barra de tareas
Si tienes más de una caja reguladora (shaper), puedes elegir cuál visualizar desde el desplegable **Shaper Nodes** (ubicado justo debajo del cuadro de búsqueda).
### Selector de tiempo
Al hacer clic en el selector de tiempo (por defecto Last 24 Hours) puedes definir el rango que se mostrará, desde 15 minutos hasta 28 días. También es posible establecer periodos personalizados (Now minus X minutes) o ventanas muy específicas.
### Panel (Dashboard)
Puedes ver qué caja reguladora se está consultando en la parte superior izquierda, junto a “Select a destination”.
El panel de LibreQoS Insight está basado en widgets y dispone de varias pestañas que se pueden editar.
#### Pestaña Traffic Overview
La pestaña predeterminada es **Traffic Overview**. Muestra el tráfico en vivo y los endpoints con mayor consumo, tanto por ASN como por nodo.
#### Pestaña Shaper
La pestaña **Shaper** muestra estadísticas de alto nivel para una caja LibreQoS determinada.
- **Active Circuit Count:** número de circuitos activos detectados (basado en el tráfico del suscriptor).
- **Throughput:** tráfico agregado del shaper.
- **Shaper Packets:** tasa de paquetes por segundo a lo largo del tiempo.
- **Shaper TCP Retransmits Percentage:** porcentaje de paquetes TCP retransmitidos (proxy de pérdida); idealmente debe permanecer por debajo del 1 %.
- **Shaper CAKE Activity:** nivel de actividad de los shapers CAKE en la red.
- **Shaper Round Trip Time:** RTT promedio del tráfico.
- **Shaper Round Trip Time Histogram:** el mismo RTT en formato histograma.
- **Shaper CPU Utilization:** uso máximo y promedio de CPU en el tiempo.
- **Shaper Memory Utilization:** uso de RAM del shaper en el tiempo.
#### Pestaña Children
- **Shaper Child Throughput:** rendimiento de cada nodo hijo de primer nivel.
- **Shaper Child TCP Retransmits:** ayuda a detectar nodos con pérdidas elevadas.
- **Shaper Child Round Trip Time:** ayuda a identificar nodos con RTT anómalo.
#### Heatmaps
Esta vista muestra heatmaps de RTT, retransmisiones y capacidad para los nodos de primer nivel del shaper.
#### Site Rankings
Esta pestaña resume la salud de los sitios / AP / etc. según RTT, retransmisiones TCP y capacidad en cada dirección.
### Node Map
Permite identificar la topología general de la red desde la perspectiva de Insight. Al pasar el cursor por los enlaces se muestra el throughput y las retransmisiones TCP actuales de ese tramo.
### Libby (Asistente IA)
Libby es una interfaz de chat asistiva para operaciones de Insight y consulta de documentación.
Guía operativa:
- Trate la salida de Libby como guía asistiva, no como comando autoritativo de cambio.
- Valide recomendaciones contra estado actual del nodo, logs y procedimientos documentados antes de aplicar cambios en producción.
- Para acciones sensibles/de alto impacto, confirme con el flujo estándar del operador (estado de servicios, estado del scheduler y ruta de rollback).
### Site Heatmap
Esta vista entrega heatmaps de RTT, retransmisiones y capacidad para cada Access Point, OLT y sitio de tu red en una sola pantalla, lo que facilita detectar puntos problemáticos rápidamente.
### Tree History
Se basa en la vista Tree Overview de la WebUI de LibreQoS y muestra el diagrama Sankey a lo largo del tiempo para identificar cuellos de botella que afecten el rendimiento.
### Reports
Insight permite generar reportes asistidos por IA sobre circuitos específicos. Estos informes usan los últimos 7 días de actividad del cliente (características por ASN, contexto de topología y contexto geográfico) e incluyen un Perfil de usuario, Hallazgos clave, Problemas críticos, Tendencias de rendimiento, una Recomendación de mejora y elementos sugeridos para revisión manual.
### Alerts
La sección **Alerts** entrega advertencias automáticas sobre comportamientos fuera de norma para nodos de la red (AP, OLT, sitios, etc.).
## Comportamiento de licenciamiento de Insight (lado nodo)
### Material de claves local y grants offline
LibreQoS guarda material de claves de Insight en:
`/.keys/`
Las compilaciones actuales pueden cachear grants firmados localmente para que el nodo siga operando durante pérdidas temporales de conectividad con servicios de control de Insight. La validez y expiración del grant se aplica localmente.
Notas operativas:
- Mantenga `.keys/` persistente entre reinicios.
- Trate `.keys/` como material sensible.
- Si hay estado inválido de grant/clave, `lqosd` mostrará errores de licencia/grant en logs.
### Límites de circuitos mapeados y estado de licencia
`ShapedDevices.csv` puede contener entradas ilimitadas. En compilaciones v2.0 actuales, la admisión al estado de shaping activo depende de un estado válido de licencia/grant con derecho.
Sin un estado válido de licencia/grant de Insight o Local, LibreQoS admite solo los primeros 1000 circuitos mapeados válidos al estado de shaping activo. Los circuitos mapeados válidos adicionales permanecen fuera del shaping activo hasta que se restaure una licencia válida con derecho.
Un estado válido de licencia/grant con derecho habilita conteos de circuitos mapeados por encima del límite predeterminado de 1000.
El comportamiento predeterminado del límite de 1000 aplica cuando el estado de licencia/grant está:
- ausente
- expirado
- inválido por cualquier motivo
- operando con estado local de grant offline inválido
Cuando se alcanza el límite, los operadores normalmente verán:
- una advertencia prominente en WebUI
- un indicador de uso en la navegación izquierda mostrando cercanía al límite
- mensajes de `lqosd` como:
- `Mapped circuit limit reached`
- `Bakery mapped circuit cap enforced`
Cuando ocurra:
1. Revise el estado de licencia en la página `License & Services`.
2. Revise `journalctl -u lqosd` para conteos requested/allowed/dropped.
3. Verifique si el nodo está operando con el límite predeterminado de 1000 circuitos mapeados porque el estado actual de licencia/grant es inválido.