Log Explorer
The Log Explorer (/logs) is where you search, filter, and inspect all log events ingested by your team. It supports full-text search, level filtering, two view modes, and CSV export.
Search
The search bar at the top of the page performs a full-text search across:
- Message — the free-form log message
- Touchpoint — the touchpoint name attached to the log event
- Category — the category the touchpoint belongs to
Search is debounced (300 ms) so the results update as you type without hammering the API.
Level filter
Use the level filter pill group to narrow results to a specific severity:
| Filter | Shows |
|---|---|
| All | Every log event |
| Errors | Events with level: "error" |
| Warnings | Events with level: "warn" |
| Info | Events with level: "info" |
The debug level is stored but not surfaced as a standalone filter tab — debug events appear when the filter is set to All.
View modes
Switch between Flat and Grouped view using the toggle in the top-right corner of the page.
Flat view
Logs are displayed in a single chronological list, newest first. Each row shows:
- Timestamp
- Level badge (color-coded)
- Touchpoint name
- Message excerpt
- API key name (which key produced the event)
Click any row to expand it and see the full metadata payload.
Grouped view
Logs are organized under their touchpoint hierarchy, mirroring the tree structure you defined in Settings → Touchpoints. This makes it easy to see which part of your system is generating noise.
Pagination
The Log Explorer loads 25 results per page. A Load more button appears at the bottom of the list if additional results are available. The total result count is shown next to the level filter.
Export
Click the Export button (top-right, next to the view toggle) to download the currently loaded results as a CSV file. The exported columns are:
- Time (ISO 8601)
- Level
- Touchpoint
- Message
The Export button is disabled when there are no logs to download.