Wireless: el Agente empieza a leer clientes y tráfico por red (VLAN) — primera pieza del filtro Red

Para qué sirve

En un evento como una feria conviven varias redes WiFi en el mismo punto de acceso — la de los visitantes, la del personal, la de los equipos de producción — y hasta ahora Wireless solo mostraba el total del aparato, sin poder separarlas. Este cambio es la primera pieza para poder filtrar las gráficas por red: el Agente que corre junto a los puntos de acceso aprende a leer cuántos clientes y cuánto tráfico lleva cada red (VLAN) por separado, y a mandarlo a CreaRack. Todavía no hay nada nuevo que ver en pantalla — el desplegable para elegir la red y las gráficas filtradas llegan en la siguiente entrega — pero el dato ya se recoge en origen.

Cómo funciona

El Agente sabe pedir datos a un punto de acceso por SNMP de varias formas (un valor suelto, sumar una columna, contar filas, tomar la primera fila). La 2.30.0 añade una quinta: walk_keyed, que recorre una columna de una tabla del equipo y saca un valor por clave en vez de un único total — la clave puede ser el número de VLAN (leído de otra columna de la misma tabla, key_oid) o el índice de la fila. Según la receta, suma las filas de una misma clave (tráfico) o las cuenta (clientes). Solo admite claves numéricas y un tope de 256 por métrica (criterio, sin medir a propósito: un punto de acceso del CCIB lleva unas 20 VLAN, caben 4094).

Las primeras recetas, sembradas por migración en los perfiles de fabricante:

• Xirrus: vlan_rx_bytes/vlan_tx_bytes (tráfico por VLAN, vlanStatsTable) y vlan_clients (clientes por VLAN, stationAssociationTable — la misma columna que ya usa el deep discovery). Medido en vivo en el CCIB (P1-Sala113, 28-09-2026): la VLAN 1764 bajó 57,7 Mbps y subió 23,1 en un minuto, y cuadra con lo que marca el cable del punto de acceso.
• Cambium: vlan_clients (ssidActiveClients sumado por ssidVlan) — sin verificar contra tráfico real; si el equipo no lo soporta, simplemente no aparece esa red para ese punto de acceso.

El contrato de nombres: el Agente emite snmp_net_<clave>__<vlan>, y el ingest del SaaS lo guarda como la serie snmp_net_<clave>{net="<vlan>"} en la base de métricas. Al escribir un perfil de fabricante se valida que walk_keyed solo se use en el bloque de OIDs lentos, con key_oid numérico y un modo de agregación conocido (suma o conteo). Un Agente anterior a la 2.30.0 no sabe qué es walk_keyed: lo trata como una lectura simple, el equipo responde “no existe” y el dato se descarta sin romper nada.

Qué falta

Compilar y publicar el binario del Agente 2.30.0 (mientras tanto la flota sigue en la 2.29.0 y no manda estos datos), y la segunda entrega: el desplegable para elegir la red y las gráficas ya filtradas.

Implementación

• terminal/agent/sentinel/snmp_extras.py — tipo walk_keyed, recorrido de filas y agregación por clave.
• monitoring/metric_names.py — patrón snmp_net_<clave>__<vlan> y su conversión a nombre de serie.
• monitoring/api/schemas.py — valida walk_keyed al guardar un perfil de fabricante.
• terminal/api/sentinel_ingest.py — aplica la etiqueta net al guardar la métrica.
• network/migrations/0068_wireless_datos_por_red.py — siembra las recetas de Xirrus y Cambium.
• Tests: tests/agent/test_agent_2300_walk_keyed.py, tests/monitoring/test_contrato_datos_por_red.py.

Commits relacionados

• 270fff395c5403f5ac84610e535babe3be8cf58d (28-09-2026) — feat(wireless): el Agente 2.30.0 lee clientes y tráfico por VLAN (walk_keyed); primera pieza del filtro Red (v1.165.0, #625, tarea #390).

Véase también

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