Log Viewer
The log viewer is the main screen of the desktop app. It’s a table of log entries with a filter bar at the top.
Columns
Section titled “Columns”| Column | Default | Description |
|---|---|---|
| Time | Visible | Timestamp of the log entry |
| Level | Visible | info, debug, warn, error with color coding |
| Message | Visible | The log message |
| Bucket | Hidden | Which bucket the log belongs to |
| Tags | Hidden | Tag key-value pairs |
| User | Hidden | User ID (from setUser()) |
| Session | Hidden | Session ID (from setSessionId()) |
| Env | Hidden | Environment string |
| App Name | Hidden | Application name |
| App Version | Hidden | Application version |
Toggle column visibility with the column selector in the filter bar.
Filtering
Section titled “Filtering”Level toggles
Section titled “Level toggles”Four toggle buttons at the top: info, debug, warn, error. Click to show/hide each level. Multiple can be active simultaneously.
Message search
Section titled “Message search”Substring search across log messages. Type in the search box and results filter in real-time.
Bucket filter
Section titled “Bucket filter”Multi-select dropdown showing all buckets in the current project. Select one or more to show only logs from those buckets.
Tag filters
Section titled “Tag filters”Dynamic dropdowns for each tag key discovered in your logs. Each shows the unique values and their counts. Select values to filter. Multiple tag filters are AND-combined.
Time range
Section titled “Time range”Presets: 5 minutes, 15 minutes, 1 hour, 6 hours, 24 hours. Or set custom from and to timestamps.
Real-time streaming
Section titled “Real-time streaming”New logs appear at the bottom of the table automatically. A green fade animation highlights new entries for 3 seconds.
Pause/resume
Section titled “Pause/resume”Click the pause button to freeze the view. While paused:
- New logs are still received and stored
- A floating pill shows “N new logs”
- Click the pill or the play button to resume and catch up
This is useful when you’re reading a specific log and don’t want the view jumping around.
Expanding rows
Section titled “Expanding rows”Click any row to expand it. The expanded view shows:
- Full message text
- Context object (formatted JSON)
- All tags
- Trace ID, user ID, session ID
- Timestamps and metadata
Log inspector
Section titled “Log inspector”Open a log in a separate floating window for detailed inspection. Useful for comparing logs side by side.
Pagination
Section titled “Pagination”The viewer keeps the last ~2,000 logs in memory. Scroll up to load older logs automatically (cursor-based pagination using beforeId).
Active filter chips
Section titled “Active filter chips”When filters are active, chips appear below the filter bar showing what’s applied. Click the X on any chip to remove that filter.