Hardware & Management • v0.13.0

Hardware Telemetry, Optical DOM & Shell Access

Monitor physical appliance health and diagnose fiber link degradation. Axonwall aggregates Linux hwmon chassis sensors, SFP+/QSFP28 DOM optical transceiver metrics, an RBAC-gated Console Command Runner, KVM HTML5 noVNC guest consoles, and full SSH / serial TUI workstations.

Linux HWMON Chassis Sensor Telemetry

Axonwall autonomously probes /sys/class/hwmon to collect core thermals, fan speeds, and power supply voltages without requiring external IPMI agents or proprietary drivers:

Thermal Monitoring

Individual CPU core temperatures (coretemp / k10temp), motherboard chipset sensors, and NVMe drive thermals.

Fan Speed Telemetry

Real-time tachometer readings (RPM), PWM duty cycle percentage, and fan stall warnings.

Voltage Rails

Input and output chassis power rails: +12V, +5V, +3.3V, and processor Vcore telemetry.

SFP+ / QSFP Optical Transceiver DOM

Diagnosing fiber-optic issues usually requires physical optical power meters. Axonwall queries the SFF-8472 / SFF-8436 Digital Optical Monitoring (DOM) registers on SFP+, SFP28, and QSFP28 transceivers via the Linux kernel ethtool -m interface:

Optical Diagnostics Data (JSON)
json
{
  "interface": "eth2",
  "transceiver": "10GBASE-SR",
  "wavelength_nm": 850,
  "temperature_c": 38.4,
  "voltage_v": 3.28,
  "tx_power_dbm": -2.1,
  "rx_power_dbm": -4.8,
  "tx_bias_current_ma": 6.4,
  "status": "nominal",
  "alarms": []
}
Optical Attenuation Warning
If physical fiber bending or dirty patch connectors cause RX optical power to drop below the manufacturer sensitivity threshold (typically -11 dBm for 10G-SR), Axonwall triggers an automated alert before CRC packet loss occurs.

Console Command Runner, SSH Workstation & Guest Consoles

Rather than exposing an unbounded persistent root WebSocket PTY to browser XSS/session hijacking risks, Axonwall separates browser diagnostics from interactive shell administration across four purpose-built channels:

1. Web Console Command Runner (/system/terminal)

Backed by axonwalld /v1/terminal/exec over the authenticated /run/axonwall/agent-api.sock Unix socket with strict RBAC administrator gating, timeout bounds, and audit logging—ideal for quick browser-based diagnostics.

2. Full Interactive SSH Workstation (cli-workstation)

Connect via OpenSSH for persistent Tmux sessions, Oh My Zsh + Starship prompts, the 12-domain Neovim Super Configurator (axonwall-config), and the 11-tab axonwall-tui cockpit.

3. KVM Guest HTML5 noVNC Consoles

Virtual machines managed by core-virt stream interactive graphical and serial guest consoles over /v1/virt/console/ws directly into the Web Console's embedded HTML5 noVNC viewer.

4. Physical VGA & RS-232 Serial Console

Out-of-band physical VGA and ttyS0 (115200 8N1) interfaces launch axonwall-console for emergency interface assignment, password recovery, and Commit-Confirm inspection.

Common Diagnostic Commands:
nft list table inet axonwall - Inspect live kernel filter
conntrack -L - Dump active connection states
ethtool -m eth2 - Raw optical transceiver DOM
journalctl -u axonwalld -f - Stream daemon logs
Access Console Command Runner & Sensors
Navigate to System > Web Shell & Sensors (/system/terminal) in the Web Console to inspect HWMON thermals, SFP+ DOM gauges, and execute RBAC-audited diagnostic commands.