frivasplata/log-viewer repository overview

Platform Overview Stellar Troubleshooting is a real-time wireless diagnostics and RF analysis platform designed specifically for senior wireless engineers, NOC teams, and escalation specialists that works with Alcatel-Lucent Enterprise Stellar WIFI solution. The system enables deep inspection of WiFi client lifecycle events, RF channel utilization, Co-Channel Interference and per-station telemetry using secure SSH connectivity or historical log ingestion. Core components include:

Real-time SSH log streaming Advanced logical filtering engine (&, |, !) Client telemetry extraction via AP shell scripting Channel utilization RF analytics Timeline reconstruction and connection stage correlation Co Channel Interference measurement and identification image System Architecture High-Level SSH Workflow: Engineer Browser ↓ Flask Web Application (Port 3005) ↓ Paramiko SSH Engine ↓ Access Point (Live Data / Scripts / Logs) All SSH sessions are isolated per request and executed with timeouts to prevent blocking. Root credentials are required for telemetry-level commands.

Fetch Logs – Deep Connection Stage Analysis The Fetch Logs module retrieves /var/log/wam.log in real time via SSH. The filtering engine supports complex logic combinations: & → Logical AND | → Logical OR ! → Logical NOT Connection Stage Reconstruction Flow: Client → Authentication → Association → EAPOL (802.1X) → 4-Way Handshake → DHCP → Network Access Engineers can isolate specific failures such as:

Authentication timeouts Association rejections EAP failures 4-Way Handshake mismatches DHCP discover/offer/request/ack anomalies Date/Time filtering enables microsecond-precision investigation during reported incident windows. image Clients Connected – Real-Time Station Telemetry This module executes root-level shell scripts on the AP to extract live per-client metrics: Columns: MAC_Address, IP Address, Band, Channel, SSID, VLAN, RSSI, Mode, Profile, Re-Tx, Time, Hostname Engineering Value: Validate RF band steering behavior Inspect MCS/Mode (HT/VHT/HE/EHT) Detect excessive retransmissions Identify incorrect VLAN assignment Measure session duration stability MAC-click pivoting allows immediate transition from telemetry view to full connection log trace. image image Channel Utilization – RF Spectrum Intelligence Channel Utilization retrieves real-time congestion metrics per radio (2.4GHz, 5GHz, 6GHz). RF Impact Flow: High Utilization → Increased Airtime Contention → Higher Retries → Reduced Throughput → Client Complaints Transient vs Persistent congestion can be identified using repeated refresh cycles. image Co-Channel Interference - RF Spectrum Intelligence CCI retrieves the number of radios connected to the same channel the AP's are connected and shows some details like the RSSI, beacon interval and the SSID those interfering radios are using in real time. image image SSH vs Local Log File Modes SSH Mode: Real-time diagnostics directly from live APs. Local Log Mode: Historical forensic analysis from stored wam.log files.

Troubleshooting Decision Tree User Complaint → Check Channel Utilization If High → RF Mitigation (Channel Change / Power Adjust) If Normal → Inspect Client Telemetry If High Retries → RF or Interference Issue If Auth Failure → Check RADIUS / EAP If DHCP Failure → Check L3 Infrastructure Else → Deep Log Filtering with Date/Time

Deployment Install: docker run -d -p 3005:3005 --restart always --name log-viewer frivasplata/log-viewer:latest

Update: docker pull frivasplata/log-viewer:latest docker stop log-viewer docker rm log-viewer docker run -d -p 3005:3005 --restart always --name log-viewer frivasplata/log-viewer:latest

Conclusion Stellar Troubleshooting provides senior wireless engineers with a unified, real-time diagnostics platform combining RF intelligence, log analytics, and client telemetry. It significantly reduces MTTR and transforms reactive troubleshooting into structured engineering analysis.