Estado del sensor local

Estado del sensor local

El sensor local es la fuente primaria de telemetría de host y red. Esta página describe cómo verificar su estado, interpretar sus indicadores y diagnosticar problemas comunes.

Panel del Sensor Local (Sidebar izquierdo)

Al abrir TraceWall, el panel lateral muestra un resumen en tiempo real:

Sección	Qué muestra	Frecuencia actualización
Host	Hostname, OS, versión, uptime	60 s
Interfaces	Lista: nombre, tipo, IPv4/IPv6, MAC, estado (up/down), gateway	30 s
CPU	Uso total %, por núcleo, frecuencia, temperatura (si disponible)	10 s
Memoria	Total, usada, libre, cache, swap	10 s
Disco	Particiones: total, usado, libre, % uso, I/O	30 s
Procesos	Top 10 por CPU/RAM, PID, nombre, usuario	30 s
Servicios	Estado (running/stopped), tipo inicio	60 s
Puertos	TCP/UDP en listen, PID/proceso, IP local	30 s
DNS	Servidores configurados, latencia resolución	60 s

Indicador de estado (esquina superior del panel):

• 🟢 Verde — Sensor activo, última muestra < 2× intervalo configurado
• 🟡 Amarillo — Sensor activo pero última muestra > 2× intervalo (posible lag)
• 🔴 Rojo — Sensor detenido o error en recolección

Settings → Sensor

Configuración detallada y estado extendido:

┌─────────────────────────────────────────────────────────────┐
│  Telemetría local:  [● Habilitado]  [○ Deshabilitado]       │
│  Intervalo de polling:  [30]  segundos  (10–300)            │
│  ─────────────────────────────────────────────────────────  │
│  Módulos activos:                                            │
│  ☑  Interfaces & ARP      ☑  Tabla de rutas                  │
│  ☑  Procesos              ☑  Servicios                       │
│  ☑  Puertos TCP/UDP       ☑  DNS local                       │
│  ☑  Estadísticas disco    ☑  Temperatura (si hwmon)         │
│  ─────────────────────────────────────────────────────────  │
│  Última recolección exitosa:  2025-01-15 14:32:17           │
│  Errores consecutivos:  0                                    │
│  Próxima recolección en:  ~12 s                              │
└─────────────────────────────────────────────────────────────┘

Verificación de salud (Checklist)

Ejecuta estos pasos tras instalación o tras cambios de configuración:

1. Panel sidebar — Estado 🟢, interfaces listadas con IPs/MACs válidas
2. Settings → Sensor — “Telemetría local” = Habilitado; intervalo = 30s (o tu valor)
3. Command Center → Tarjeta Sensor — Última muestra < 2 min, CPU/RAM coherentes
4. Local Sensor (módulo completo) — Todas las pestañas (Interfaces, Procesos, Puertos, Rutas, DNS) muestran datos
5. Assets & Inventory — El host local aparece como activo tipo “host”, confidence ≥ 0.9, reachable = true
6. Network Topology — Nodo gateway detectado, subred local renderizada

Problemas comunes y diagnóstico

Síntoma	Causa probable	Verificación	Acción
Panel muestra “Sin datos” / 🔴	Sensor detenido	Settings → Sensor → errores consecutivos > 0	Reiniciar app; revisar logs (%LOCALAPPDATA%\TraceWall\logs\)
Interfaces vacías	Npcap faltante (Win) / Permisos (Linux)	Windows: sc query npcap / Linux: `capsh —decode=$(cat /proc/self/status	grep CapEff)`
Solo interfaz loopback	Filtro de interfaz mal configurado	Settings → Sensor → “Interfaces a ignorar”	Limpiar lista de ignoradas; dejar solo lo, docker*, veth*
CPU/RAM siempre 0%	Contadores de rendimiento deshabilitados (Win)	lodctr /q → buscar “Disabled”	lodctr /e:PerfLib o reconstruir contadores: winmgmt /resyncperf
Puertos vacíos	Sensor sin privilegio para netstat/ss	Linux: ss -tulpn manual	Ejecutar con CAP_NET_ADMIN o como root (no recomendado)
DNS muestra servidores pero latencia ”-“	Resolución fallando	nslookup google.com / Resolve-DnsName google.com	Verificar conectividad a servidores DNS; revisar firewall local
”Última recolección” > 5 min	Sensor pausado / hilo bloqueado	Logs: buscar sensor.collect	Reiniciar app; si persiste, reportar con logs

Logs relevantes

Archivo	Qué buscar
sensor.log	Ciclos de recolección, errores por módulo, timings
main.log	IPC sensor↔main, reinicios de sensor, health checks
ipc.log	Invocaciones Renderer→Main para datos de sensor

Ubicaciones:

• Windows: %LOCALAPPDATA%\TraceWall\logs\
• Linux: ~/.local/share/tracewall/logs/

Métricas de calidad de telemetría

Métrica	Objetivo	Alerta si
Latencia recolección completa	< 2 s	> 5 s sostenido
Tasa de éxito módulos	100%	< 95% en 1 h
Cobertura interfaces	Todas UP + gateway	Falta gateway o interfaz física
Freshness (última muestra)	< 2× intervalo	> 5× intervalo

Páginas relacionadas

• Primer inicio — Secuencia completa post-instalación
• Recorrido de la interfaz — Navegación y módulos
• Command Center — Tarjeta de sensor en dashboard
• Local Sensor (módulo) — Documentación completa del módulo
• Configuración: Sensor — Opciones detalladas
• Solución de problemas: Sensor inactivo
• Solución de problemas: Interfaces no detectadas