Skip to content

Logs

The Logs page corresponds to the /logs sidebar destination.

It has two main modes:

  • application log files stored on disk
  • live process logs polled from running services

Logs page with file selection, filters, search, and export controls Logs page in dark mode

What you can do on the page

  • choose a log file
  • filter by level and source
  • search with plain text or regex
  • move between search matches
  • export the current view as text, CSV, or JSON
  • open the log directory in the OS file browser
  • clean up old log files

Process view

When you switch to process view, the page polls live process logs while the page is visible.

This is useful for:

  • engine startup failures
  • container-engine diagnostics
  • runtime crashes
  • health-check debugging

Current log locations

The app-data root is currently:

Platform App data root Logs directory
macOS ~/Library/Application Support/ai.backend.go/ ~/Library/Application Support/ai.backend.go/logs/
Windows %APPDATA%\ai.backend.go\ %APPDATA%\ai.backend.go\logs\
Linux ~/.local/share/ai.backend.go/ ~/.local/share/ai.backend.go/logs/

The older ~/.backend-ai-go/ location is legacy-only. Current desktop log files live under the ai.backend.go app-data root.