Performance Dashboard¶
The Performance Dashboard gives you real-time visibility into cli_debrid's CPU and memory usage. Useful for diagnosing slowdowns, memory leaks, or high resource consumption.
Access it by clicking the Uptime card on the Dashboard, or from System → Performance Dashboard. Hovering the menu entry opens its tabs directly.
The dashboard has four tabs:
| Tab | What it shows |
|---|---|
| Performance | CPU and memory, described on the rest of this page |
| Connections | Whether each scraper, provider and service is reachable |
| Scraper Stats | Per-scraper results and timings |
| Diagnostics | Token status, rate limits and API calls — see Diagnostics below |
The Connections, Scraper Stats and Diagnostics tabs load when you open them and stop refreshing when you leave. Their old page addresses open the matching tab.
Header actions¶
| Button | Description |
|---|---|
| Memory Snapshot | Capture a live memory snapshot — run this while memory is high to diagnose what's consuming RAM |
| Trim Memory | Run gc.collect() + malloc_trim(0) to release glibc arena pages back to the OS. Shows before→after MB and freed MB after completing. |
| Export Data | Download the full performance data as a JSON file — useful for sharing with support or offline analysis |
System Resources¶
Live CPU and memory progress bars showing current usage percentage.
| Metric | Description |
|---|---|
| CPU Usage | Current CPU usage % with user time and system time breakdown |
| Memory Usage | System memory usage % with RSS, Virtual Memory, and Swap Used details |
Memory Analysis¶
Summary statistics calculated from the last hour of readings:
| Metric | Description |
|---|---|
| Average RSS Memory | Mean resident set size over the period |
| Peak RSS Memory | Highest RSS reading in the period |
| Average Virtual Memory | Mean virtual address space over the period |
| Peak Virtual Memory | Highest VMS reading in the period |
| Anonymous Memory | Memory not backed by a file — size and mapping count |
| File-backed Memory | Memory mapped from files — size and mapping count |
| Open Files | List of currently open file handles with path and size |
Memory Growth¶
A line chart showing RSS and VMS over the last hour. Also shows a snapshot table with readings at 10-minute intervals displaying RSS, VMS, and Swap at each point.
A steadily climbing RSS line indicates a potential memory leak.
| Series | Description |
|---|---|
| RSS Memory | Resident Set Size — actual RAM in use |
| Virtual Memory | Total virtual address space allocated |
Resource Handles¶
| Metric | Description |
|---|---|
| Open Files | Total count of open file handles |
| File Types | Distinct file extensions currently open |
CPU Profile¶
Historical CPU usage chart for the last hour plus a detailed summary:
| Metric | Description |
|---|---|
| Average CPU | Mean CPU usage % over the period |
| Peak CPU | Highest CPU spike in the period |
| CPU Time | Cumulative user and system time since process start |
| Active Threads | Number of running threads with per-thread user/system time and a visual bar |
Memory Snapshot¶
Click Memory Snapshot to capture a detailed live snapshot. The result panel shows:
| Field | Description |
|---|---|
| RSS Memory | Current resident set size |
| Virtual Memory | Current virtual memory size |
| Active Threads | Thread count at snapshot time |
| Session Store | Number of active sessions |
| Task Queue | Queued and completed task counts |
| Function Cache | Number of cached function entries |
| Scan Progress Keys | Active scan progress trackers |
| Analysis Progress Keys | Active analysis progress trackers |
| Notification Queues | Number of notification queues |
| Top Python Object Types | Table of the most numerous Python object types by count — useful for identifying memory leaks |
| Thread Names | Expandable list of all active thread names |
Click Download in the snapshot panel to save it as a JSON file.
Auto-refresh¶
The dashboard refreshes automatically every 60 seconds.
Healthy baselines¶
For reference, typical memory usage:
| State | Expected RSS |
|---|---|
| Cold start (no activity) | ~280–300 MB |
| Warm idle (after running) | ~350–400 MB |
| Active scraping | ~400–500 MB |
Diagnostics¶
The Diagnostics tab holds the status checks that used to be on the Debug page's Monitoring tab.
| Section | What it shows |
|---|---|
| Current Rate Limit State | Rate limiting for each external API (Trakt, debrid and others), with 5-minute and hourly counts. Warnings show when a limit is exceeded, which tells you whether cli_debrid is being throttled. |
| Plex Token Status | Every configured Plex token by user: valid or not, Plex username, expiry and when it was last checked |
| Personal Trakt Token Status | Your own Trakt sign-in: valid or not, expiry, hours left and when it was last refreshed |
| Torrent Tracking | A link to the history of every torrent added and its current status |
| API Summary / Real Time API | How many calls cli_debrid makes to each API, in total and live |
To send a test notification, use the Test button on the Notifications settings page. To share logs, use Share cli_debrid Logs on the Logs page.
