This commit is contained in:
Robert Chacon committed 2026-03-28 20:48:44 -06:00
1 parent 6187ae47d3
commit f28c573de8
4 files changed
+400 -118

No files matched your search

+16 -14
View File
@@ -9,15 +9,15 @@ Esta página documenta las vistas clave de la WebUI (Node Manager) y su comporta
- El contenido puede variar según versión y funciones habilitadas.
- Executive Summary ofrece una vista operativa compacta para redes grandes, con páginas de detalle para heatmaps y rankings ejecutivos.
- Bakery ofrece una pestaña dedicada para el estado de aplicación de colas, eventos recientes de Bakery paginados, resultados de seguridad/preflight de qdisc y el gráfico existente de actividad de circuitos.
- Las pestañas de Bakery y TreeGuard ahora comienzan con una fila visual de modelo del sistema para que el operador entienda el comportamiento del pipeline/control loop de un vistazo antes de bajar a tablas.
- El widget `Pipeline` de Bakery ahora incluye la barra de progreso activa dentro de la misma tarjeta, con `%`, `completado / total de comandos tc` y avance por chunk durante full reloads grandes.
- La fila superior de Bakery ahora incluye `Runtime Operations`, que muestra mutaciones en vivo de topología entre TreeGuard y Bakery, trabajo de limpieza diferida, fallos, subárboles marcados como `Dirty` y si Bakery ha congelado más cambios incrementales hasta hacer un full reload.
- `Recent Bakery Events` ahora separa cada evento en etapa, resultado y alcance para que el operador pueda ver rápidamente si Bakery está planificando, bloqueado en preflight, aplicando, limpiando trabajo de TreeGuard o si ya terminó.
- `TreeGuard Activity` ahora prioriza intención y resultado en lugar de una columna cruda de `persisted`, haciendo mucho más fácil interpretar dry-runs, cambios aplicados, acciones con limpieza pendiente, skips y fallos.
- `TreeGuard Decision Impact` ahora separa advertencias operativas de errores reales, usa ámbar en lugar de rojo para advertencias no fatales y expone el texto actual de advertencias/errores directamente en el resumen del widget y en el tooltip al pasar el cursor.
- El preflight de qdisc de Bakery ahora presenta los qdisc planificados por interfaz como barras compactas de uso con badges del tipo de qdisc, además de una tabla separada de límites/memoria para presupuesto seguro, límite del kernel, memoria estimada de qdisc, memoria disponible actual y margen sobre el piso de seguridad.
- Las pestañas de Bakery y TreeGuard incluyen un resumen de alto nivel del pipeline/control loop antes de las tablas detalladas.
- El widget `Pipeline` de Bakery muestra el progreso activo de aplicación, incluyendo porcentaje completado, conteo de comandos y avance por chunk durante full reloads grandes.
- `Runtime Operations` resume mutaciones en vivo de topología entre TreeGuard y Bakery, trabajo de limpieza diferida, fallos, subárboles marcados como `Dirty` y si los cambios incrementales están congelados hasta un full reload.
- `Recent Bakery Events` ayuda a distinguir rápidamente estados de planificación, preflight, aplicación, limpieza y finalización.
- `TreeGuard Activity` se centra en la intención y el resultado operativo, incluyendo dry-runs, cambios aplicados, skips, acciones con limpieza pendiente y fallos.
- `TreeGuard Decision Impact` separa advertencias operativas de errores reales y expone el texto actual de advertencia o error en el resumen del widget y en el tooltip.
- El preflight de qdisc de Bakery resume el uso planificado de qdisc por interfaz y el margen de presupuesto antes de aplicar cambios.
- Algunos gráficos pueden tardar un poco en poblarse al abrir una pestaña por primera vez, especialmente en sistemas ocupados o inmediatamente después de reiniciar servicios.
- Durante un full reload de Bakery, las tarjetas de conteo de colas mantienen los últimos valores conocidos de HTB/CAKE/fq-codel y los marcan como `Reloading` en lugar de mostrar ceros momentáneamente.
- Durante un full reload de Bakery, las tarjetas de conteo de colas mantienen los últimos valores conocidos de HTB/CAKE/fq-codel y los marcan como `Reloading`.
### Vista de árbol de red
- Vista jerárquica de nodos/circuitos desde la perspectiva del shaper.
@@ -33,8 +33,10 @@ Esta página documenta las vistas clave de la WebUI (Node Manager) y su comporta
- Usa QoO por defecto con un selector alternativo para RTT, mientras el tamaño del marcador refleja el throughput combinado reciente.
- Usa un promedio del lado cliente de 30 segundos a partir de `NetworkTree`, sin agregar trabajo de rollup en el backend.
- Los APs pueden heredar coordenadas del sitio padre solo para visualización cuando faltan coordenadas explícitas.
- Los marcadores de sitios cercanos se agrupan y se expanden al acercar el mapa o seleccionar un grupo.
- Los APs sin coordenadas explícitas se representan a través de su sitio padre y pueden desplegarse temporalmente alrededor del sitio seleccionado para inspección.
- Cuando el modo de redacción del navegador está habilitado, Site Map reemplaza los nombres de sitios mostrados por `[redacted]` sin modificar los datos reales de topología.
- El encuadre inicial del mapa ahora prioriza las coordenadas de los sitios para una vista inicial más cercana, usando coordenadas de AP solo cuando todavía no hay sitios mapeados.
- El encuadre inicial del mapa prioriza las coordenadas de los sitios para la vista inicial, usando coordenadas de AP solo cuando todavía no hay sitios mapeados.
- Usa un mapa base local con estilo LibreQoS con bordes de país/estado, costas, lagos principales, ríos principales, áreas marinas, superposiciones sutiles de regiones físicas y contexto de autopistas principales a mayor zoom para orientación geográfica.
- Site Map utiliza una capa local de carreteras derivada de Natural Earth para ayudar con la orientación, manteniendo el resto del mapa base discreto y operativo.
@@ -49,16 +51,16 @@ Esta página documenta las vistas clave de la WebUI (Node Manager) y su comporta
### ASN Analysis
- Página operativa ASN en vivo que combina un ranking top-20 de ASN, gráfico de burbujas latencia-vs-tráfico, franja mínima de KPIs del ASN seleccionado, gráfico de tendencia ASN de 15 minutos y la sección integrada de Flow Evidence.
- Soporta modos de ranking `Impact` y `Throughput`, manteniendo la evidencia de flujos ASN en la misma página.
- Las versiones actuales obtienen el contexto ejecutivo ASN mediante requests paginados y acotados solo a ASN, en lugar de suscribirse a un feed completo de heatmaps ejecutivos.
- La ruta heredada `ASN Explorer` ahora redirige aquí para conservar compatibilidad con marcadores antiguos.
- El contexto ejecutivo ASN se obtiene mediante requests acotados al ASN, en lugar de suscribirse a un feed completo de heatmaps ejecutivos.
- Los marcadores antiguos de `ASN Explorer` siguen funcionando mediante redirección.
- Resultados vacíos suelen indicar poco dato reciente, no necesariamente falla.
### Página de circuito
- Las páginas de circuito combinan comportamiento de colas, throughput en vivo, RTT, retransmisiones y troubleshooting por flujo para un suscriptor/circuito individual.
- `Queue Dynamics` muestra el comportamiento del throughput y RTT del circuito a lo largo del tiempo, incluyendo un KPI de `Active Flows` basado en la misma ventana reciente usada por la tabla `Traffic Flows`.
- `Queue Stats` muestra los 3 minutos más recientes del historial en vivo de la cola del circuito como muestras scatter crudas de 1 segundo, incluyendo backlog, delay, longitud de cola, tráfico, marcas ECN y drops.
- Los gráficos de Queue Stats ahora usan hover sincronizado para inspeccionar el mismo segundo en todos los gráficos de cola al mismo tiempo.
- `Queue Tree` ahora presenta la ruta ascendente de colas del circuito en tarjetas de ancestros con estilo, incluyendo un resumen de ruta y paneles de throughput, retransmisiones y latencia de igual ancho para cada nodo aguas arriba.
- Los gráficos de Queue Stats usan hover sincronizado para inspeccionar el mismo segundo en todos los gráficos de cola al mismo tiempo.
- `Queue Tree` muestra la ruta ascendente de colas del circuito, incluyendo un resumen de ruta y contexto de throughput, retransmisiones y latencia para cada nodo aguas arriba.
- `Traffic Flows` es una tabla operativa de flujos recientes, no una vista de historial a largo plazo.
- `Traffic Flows` incluye paginación y un filtro `Hide Small Flows` para que los circuitos grandes y ocupados sigan siendo utilizables sin intentar renderizar cada fila.
- `Flow Sankey` enfatiza los flujos recientes más activos en lugar de todos los flujos retenidos más antiguos.
@@ -70,7 +72,7 @@ Esta página documenta las vistas clave de la WebUI (Node Manager) y su comporta
### Editor de Shaped Devices
- Editor CRUD para `ShapedDevices.csv`.
- Incluye paginación y filtros en versiones actuales.
- Incluye paginación y filtros.
- En el editor dedicado, las acciones de agregar, editar y eliminar se guardan de inmediato.
### Problemas urgentes