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 theme setting (default on most systems)
- Light - Always use light theme
- Dark - Always use 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
Plot Defaults¶
Default settings for new plot panels:
Fill Plot Areas
- Enable or disable area shading under plot lines
- Default: Off
Line Path Mode
- Stepped (default) - Flat lines between points
- Linear - Straight lines between points
- Spline - Smooth curved lines
- Natural - Natural cubic spline curves
Logs¶
View Logs Folder
- Opens the folder containing application logs
- Logs include errors, warnings, and debug information
Log Retention
How long to keep log files:
- 7 days - Minimal disk usage (~50 MB)
- 14 days - Default (~100 MB)
- 30 days - Extended retention (~200 MB)
Older logs are automatically deleted.
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