Settings¶
Access settings through the Settings button in the app rail (far left edge). Settings open as a dedicated tab in your workspace.
Settings Tab Behavior
Only one Settings tab can be open per workspace. If already open, clicking the Settings button activates the existing tab.
Theme¶
Control the app's appearance:
- System - Follow your OS light/dark setting
- Light - Always use the light theme
- Dark - Always use the dark theme (default)
Changes apply immediately.
Data Retention¶
How long to keep live data before it is pruned:
- 1 hour - Minimal memory usage
- 8 hours - Default, balanced memory usage
- 24 hours - Extended retention
Longer retention uses more resources, but allows viewing older live data without reconnecting. In memory mode this increases RAM usage; in disk mode it can also increase disk usage. This setting applies to both memory and disk stores. Disk mode survives restarts, but data older than the retention window is still pruned.
Store¶
Store Type
Choose how live data is stored:
- Memory - Fastest option. Live data is kept in memory only and is lost on restart.
- Disk - Stores live data on disk so it survives normal restarts.
- Changing the store type requires restart.
- Disk store is currently in beta.
On a normal shutdown, the disk-backed store flushes remaining buffered data before exit. Force-quitting the app or agent can still lose the newest buffered samples.
Memory Limit
Shown when Store Type is set to Memory on Linux
Maximum memory usage before live data pruning begins:
- Set as percentage of system memory or absolute value (MB/GB/TB)
- Default: 25% of system memory
- Minimum: 100 MB
- Unlimited: Disable the memory cap and rely on time-based retention only
Disk Size Limit
Shown when Store Type is set to Disk
Maximum disk space for live trace data:
- Set in MB, GB, or TB
- Unlimited disables size-based pruning
- When the limit is exceeded, the oldest on-disk data is pruned first
Store Folder
Shown when Store Type is set to Disk
Choose where disk-backed live data is stored:
- Leave empty to use the default app data location
- Changing the folder requires restart
Clear Store Data
Remove all live data from the current store:
- Works for both memory and disk modes
- Cannot be undone
Panel Defaults¶
Default options applied to newly created panels. These preferences are stored locally in the app (per installation) and are not synced to the agent or other devices. Changing a default never affects existing panels — each panel keeps the options it was created with, and any option can still be overridden from an individual panel's settings.
All Panel Defaults¶
Apply to newly created panels of any type:
- Show empty signals - Keep signals visible when they have no data in the current view. On by default.
- Show full name - Show each signal's full path instead of just its name. Off by default.
Plot Panel Defaults¶
Defaults for new plot panels:
- Interpolation - How the line connects samples: Linear (default, straight segments), Stepped (hold each value until the next sample), or Spline (smooth curve).
- Sample markers - Whether to draw a marker at each sample: Auto (default), Always, or Off.
- Marker size - Marker diameter from 1–12 px (default 3); ignored when sample markers are Off.
- Line width - Stroke width for every series: Thin, Normal (default), Thick, or Bold.
- Line pattern - Stroke pattern for every series: Solid (default), Dashed, or Dotted.
- Area fill - Shade the area between each line and its baseline. Off by default.
Logs¶
Logs Folder
- Opens the folder containing application log files
- Logs capture errors, warnings, and diagnostic information
Log Retention
How long to keep log files before they are deleted:
- Selectable from 1 day up to 30 days
- Default: 14 days
Older logs are removed automatically.
Share usage analytics
- Enabled by default
- Helps improve the app by sending anonymous usage data
- Turn it off to stop sharing usage analytics from this installation
Performance¶
Framerate
UI update frequency for time axis:
- Range: 1-60 fps
- Default: 30 fps
- Lower rates reduce CPU usage
Minimum Fetch Interval
Throttles data refresh rate:
- Options: None, 30ms, 60ms, 100ms, 250ms, 500ms, 1000ms
- Default: None
- Prevents rapid re-fetching
Plot Optimization
Data query strategy:
- M4 (default) - Intelligent downsampling for better performance
- None - Full resolution (raw data)
Developer Mode¶
Enable developer-specific features:
Debug Logs
- Saves additional logging during trace capture
- Helpful for troubleshooting
Performance Overlay
- Shows performance metrics
- Toggle with
Ctrl+D
Restart Agent
- Manually restart the background agent process
Current Version¶
Displays installed app version.
Check for Updates¶
Manual Check
- Click "Check for Update" to check immediately
- Auto-checks every 5 minutes when running
Update Channel
- Release (default) - Stable releases
- Alpha - Pre-release versions for testing
Update and Restart
- One-click update installation
- Downloads and installs available updates
- Requires app restart
Release Notes
- View changes in new versions
- NEW badge appears when updates are available
Next Steps¶
-
Sign in and authenticate
-
Save and share layouts
-
Master workspace features