Desplegable "Red" en las gráficas de Wireless: clientes y tráfico de una sola VLAN (tarea #390, v1.166.0)

User value

En la ficha de un grupo o de un punto de acceso Wireless, junto al botón “Add Chart” hay ahora un desplegable llamado “Red”. Antes, las gráficas de clientes conectados y de tráfico mezclaban todos los dispositivos del punto de acceso o del grupo sin distinción; con el desplegable se puede elegir una red WiFi concreta (identificada por su SSID y su VLAN) y ver solo los datos de esa red — por ejemplo, aislar el tráfico de la red de invitados de una feria del resto del tráfico del edificio.

El desplegable solo ofrece las redes de las que el punto de acceso realmente da datos por separado (no promete algo que el aparato no puede entregar), y muestra cuántos puntos de acceso del grupo aportan ese dato. Al elegir una red, las gráficas de “Station Count” (clientes) y “AP Bandwidth” (tráfico) la reflejan y lo dicen en su cabecera; las gráficas que no dependen de la red (ruido, canal, potencia por radio) siguen mostrando el punto de acceso entero y también lo avisan. La vista ampliada de una gráfica (BIG) hereda la red elegida y la añade a su título. La elección se recuerda por grupo o por punto de acceso en el navegador del usuario.

Hoy solo hay datos por red en puntos de acceso Xirrus (clientes y tráfico) y Cambium (clientes); el resto de marcas se van sumando según lo que cada una permite leer por SNMP (documentado en el estudio producto-multimarca/FILTROS_WIFI_MULTIMARCA.md del workspace).

Cómo usarla

1. Entrar en la ficha de un grupo Wireless o de un punto de acceso individual.
2. Junto a “Add Chart” aparece el desplegable “Red” (deshabilitado con el aviso “Loading networks…” mientras carga).
3. Si el punto de acceso o grupo tiene redes con dato, el desplegable lista cada una como SSID · VLAN <n> (X of Y APs); si no hay ninguna, queda deshabilitado con el aviso “No per-network data yet for these access points.”
4. Al elegir una red, “Station Count” y “AP Bandwidth” pasan a mostrar solo esa red; el resto de gráficas siguen con el punto de acceso completo.
5. Abrir una gráfica en grande (BIG) conserva la red elegida, también al imprimir o exportar a PNG.

Implementación

• Backend nuevo: monitoring/api/wireless_networks.py (módulo aparte porque wireless.py ya pasaba de 500 líneas, Regla 5). Dos endpoints Django Ninja, protegidos por require_perm(request, "observatory", "view") y acotados a la organización del usuario (require_org):
  • GET /wireless/networks?group_id=|target_id=: redes (VLAN) con dato en los últimos 10 minutos (UNVERIFIED: margen sobre la cadencia mínima de sondeo del Agente), con su nombre de SSID (leído de la foto del deep discovery, ssidName/ssidVlan), el número de clientes y cuántos puntos de acceso aportan clientes/tráfico.
  • GET /wireless/network-series?metric=station_count|throughput&net=<vlan>: la serie de una red — clientes vía last_over_time, tráfico vía rate de los contadores de bytes (snmp_net_vlan_rx_bytes/tx_bytes) convertido a Mbps. Devuelve la misma forma (data / in_mbps+out_mbps) que el resto de gráficas Wireless para que se pinten igual.
  • Ambos endpoints solo aceptan net numérico (regex ^\d{1,5}$) y validan que el grupo o el punto de acceso pertenezcan a la organización antes de consultar.
• Frontend: WirelessChartRegistry.js marca station_count y throughput como netFilterable: true; WirelessChartGrid.js monta el desplegable, guarda la elección en localStorage por grupo/AP, y pasa la red elegida a cada panel (WirelessChartPanel.js, WirelessSeriesLoader.js) para que pida la serie filtrada en vez de la del punto de acceso entero; WirelessExpertChart.js la hereda en la vista BIG.
• Tests: tests/monitoring/test_wireless_networks_api.py (backend, incluye 404 grupo/AP inexistente y 400 red o métrica inválida) y frontend/src/__tests__/static/wireless_net_filter.test.js (JS).
• Precede a este cambio: v1.165.0 (commit previo de la misma tarea #390) añadió al Agente el tipo de lectura SNMP walk_keyed, que es lo que permite a Xirrus/Cambium escribir snmp_net_vlan_clients/rx_bytes/tx_bytes con una fila por VLAN — sin esa pieza, estos dos endpoints no tendrían datos que leer.

Commits relacionados

• f60915fc (28-09-2026, PR #626) — v1.166.0: el desplegable “Red” y los dos endpoints de este documento.
• 270fff39 (28-09-2026, PR #625) — v1.165.0: walk_keyed en el Agente 2.30.0, primera pieza (la fuente de los datos por VLAN).

Véase también

• [[feature—wireless—deep-discovery-timestamp]]
• [[feature—wireless—clientes-vivos-ahora]]
• [[feature—monitoring—group-toolbar]]
• [[feature—monitoring—dashboard-customize]]
• [[crearack-tech—architecture—wireless-monitor]]
• [[crearack—wireless—dashboard-and-charts]]
• [[concept—general—resumen-del-catalogo-de-features-de-crearack-pro-m]]