Logs View¶

The Logs View provides real-time streaming and searching of qBitrr log files. Select a log file, follow live appends over SSE (with poll fallback), filter by level, and search across the current file and rotated siblings.

Overview¶

qBitrr generates structured logs for all major components:

• All.log: Aggregated events from the supervisor, WebUI, and Arr workers (default selection)
• Main.log: Core application events, initialization, shutdown
• WebUI.log: Flask/Waitress HTTP server logs, API requests
• \<ArrName>.log: Per-instance logs (e.g., Radarr-Movies.log, Sonarr-TV.log)
• Rotated logs: Renamed on restart (e.g., Main.log.old) and other *.log* siblings

The Logs view provides:

• Live streaming: SSE byte-cursor stream when Live is on; falls back to JSON delta polling (~1.8s)
• File selection (required): Dropdown of all *.log* files under the logs directory
• In-buffer search: LazyLog find / next-prev on the loaded window
• Server search: Full-file (+ optional rotated) search with jump-to-context
• Level chips: Client-side filter of the loaded buffer (ERROR, WARNING, …)
• Follow / Jump to latest: Auto-scroll with pause-on-scroll-up
• Download / Copy: Export the selected file or copy the loaded buffer

UI Components¶

Log File Selector¶

Location: Top toolbar → dropdown (leftmost)

Selecting a file resets the live stream cursor, ring buffer, follow state, and search results.

Default Selection: All.log (falls back to the first available file)

Live / Follow¶

Live updates only run when the Logs tab is active, Live is on, and you are at the live tail (not browsing older history).

Level chips¶

Toggle one or more levels to filter the in-memory buffer before display. Clear filters restores the full buffer. Matching uses the logger's LEVEL: token (ANSI stripped).

Server search¶

Location: Search row below the level chips

1. Enter a query and optionally enable Include rotated
2. Click Search file (or press Enter)
3. Results list file, line number, and snippet
4. Click a match to open a ~200-line window around that line (switches file if the hit is in a rotated sibling)

Use LazyLog's built-in search (Ctrl/Cmd-F style within the viewer) for fast find inside the current buffer only.

Status line¶

Shows selected file · buffer line count · Live (SSE) / Live (poll) / Paused / Paused (history).

Live transport¶

Select file → GET JSON tail (lines=2000)
           → EventSource /web/logs/<name>/stream?since_bytes=&inode=
           → on failure → GET JSON delta polling (same payload shape)

• Initial and delta responses are JSON (format=json or since_bytes=):

{
  "content": "...",
  "next_bytes": 123456,
  "size": 123456,
  "inode": 42,
  "rotated": false,
  "truncated": false
}

• SSE events: append, rotated, ping (~15s), reconnect (~2 minutes — client reconnects with the last cursor). Lifetime is capped so Waitress worker threads are not held indefinitely under concurrent tails.
• Client ring buffer caps at 20,000 lines while live (oldest dropped).
• Auth: EventSource uses the /web/* session cookie (cannot set Authorization). Prefer /web/logs/.../stream for the SPA.

Log Format¶

qBitrr file handlers use ColoredFormatter with a pattern similar to:

[%(asctime)-15s] %(levelname)-8s: %(name)s: %(message)s

Example (ANSI omitted):

[2025-11-27 10:30:15] INFO    : qBitrr.Main: Starting qBitrr

Levels include TRACE, DEBUG, INFO, NOTICE, SUCCESS, WARNING, ERROR, CRITICAL. Configure via:

[Settings]
ConsoleLevel = "INFO"

On restart, active logs are renamed to *.log.old (not size-based RotatingFileHandler backups).

API Endpoints¶

All routes below have /api and /web mirrors and require authentication when WebUI auth is enabled.

GET /api/logs¶

List log filenames: { "files": ["All.log", "Main.log", ...] }.

GET /api/logs/\<name>¶

Without format=json / since_bytes, legacy plain-text responses remain available.

GET /api/logs/\<name>/stream¶

SSE live tail. Query: since_bytes, inode, lines. Prefer /web/... with a session for browsers.

GET /api/logs/\<name>/search¶

Response:

{
  "query": "connection refused",
  "truncated": false,
  "matches": [
    {
      "file": "Main.log",
      "line": 10422,
      "text": "...",
      "context_before": ["..."],
      "context_after": ["..."]
    }
  ],
  "files_searched": ["Main.log", "Main.log.old"]
}

GET /api/logs/\<name>/download¶

Download the full file as an attachment.

Troubleshooting¶

Related¶

• API reference — endpoint details
• Debug logging — ConsoleLevel and verbose diagnostics