Skip to content

debugging.md

Latest commit

 

History

History
116 lines (78 loc) · 2.57 KB

debugging.md

File metadata and controls

116 lines (78 loc) · 2.57 KB

Debugging

Kernel Logs

# Follow kernel logs
journalctl -u volt-kernel.service -f

# View desktop service logs
journalctl -u volt-desktop.service

# All Volt daemon logs
journalctl -t volt-kernel-b
journalctl -t volt-ram-manager
journalctl -t volt-worker-pool

All Volt Service Logs

# Kernel A (frontend, port 9999)
journalctl -u volt-kernel.service

# Kernel B (backend, port 9998)
journalctl -u volt-kernel-b.service

# VRM — Video/RRAM Manager
journalctl -u volt-vrm.service

# VUM — Update Manager
journalctl -u volt-vum.service

# VGM — GPU Monitor
journalctl -u volt-vgm.service

# DWP — Dedicated Worker Pool
journalctl -u volt-dwp.service

# ASC — Adaptive System Config
journalctl -u volt-asc.service

# Unifier — bridges Kernel A and Kernel B
journalctl -u volt-unifier.service

# Desktop — Electron shell
journalctl -u volt-desktop.service

Developer Tools

The Electron renderer supports standard Chrome DevTools:

  • Open DevTools: Ctrl+Shift+I or Cmd+Option+I
  • Console: Kernel messages are gated to dev mode in kernelClient.ts
  • Network: Inspect WebSocket communication on ws://localhost:9999 and ws://localhost:9998

Enabling Debug Mode

Set the DEBUG environment variable before launching:

DEBUG=1 volt-desktop

Observability Endpoints

Refer to VOLT Architecture Chapter 19 for the full observability specification, including:

  • /metrics — Prometheus metrics for all Volt services
  • /health — Health check endpoints per daemon
  • /debug/vars — Exposed Go runtime vars for Kernel A and B
# Example: health check the unifier
curl http://localhost:9100/health

# Example: VRM memory usage metrics
curl http://localhost:9101/metrics | grep vrm

Common Issues

Issue Check
Desktop not starting journalctl -u volt-desktop.service
Kernel connection refused systemctl is-active volt-kernel.service
AI models not loading ls -la /opt/volt/ai-models/
WiFi not working iwconfig or nmcli device status
GPU acceleration Verify Metal/Vulkan driver presence
VRM allocation failure journalctl -u volt-vrm.service
Unifier bridge down journalctl -u volt-unifier.service

Related


← Back: Documentation Index