Telebugs Telebugs Self-hosted error tracking without the Sentry stack telebugs.com

Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The Telebugs Manual

Individual Project View

Click a project to open its dashboard for analyzing errors.

Key elements:

  • Project picker: Search the projects you can access, switch to a matching project, or open the current project’s settings. Press Enter when the search leaves one match.
  • Releases link: View release history.
  • Search bar: Find errors by type, message, or culprit; combine text with structured qualifiers; or find one exact occurrence by its occurrence ID (live updates).
  • Date range selector: Filter by time (e.g., today, last week) with pager, and compare supported ranges with the immediately preceding period.
  • Stats overview: Total reports, new vs. reoccurred.
  • Interactive chart: Error volume over time; expand it for closer inspection. Open View data table for exact values and release links, or download the displayed data as CSV.
  • Error list: Grouped unique errors with type, message, timestamp, and count. Click for details.
  • Filters: unresolved and resolved; sort by last seen or count. Muted errors remain in the appropriate list and display a mute-status badge.

If no errors, dashboard shows SDK setup instructions. Refreshes automatically as reports arrive.

Use search and filters to triage high-volume unresolved errors. Chart helps spot deploy or traffic patterns.

Search Syntax

Project search accepts free text and structured qualifiers in the same query:

checkout
checkout severity:error
checkout severity:error tags.component:payments
is:resolved severity:warning
environment:production server_name:storefront-web-03
tags.component:payments

Free text searches the error type, message, and culprit. The following qualifiers are supported:

QualifierMeaning
is:unresolved, is:resolvedFilter by resolution status
is:muted, is:unmutedFilter by mute status
severity:LEVEL or is:LEVELFilter by fatal, error, warning, info, debug, or sample_level
severity:error,warningMatch any listed severity
!severity:errorExclude a severity
environment:VALUEMatch an environment
server_name:VALUEMatch a server or device name
tags.KEY:VALUEMatch an arbitrary report tag

Quote a value when it contains spaces, for example environment:"production west". Different qualifiers combine with AND; comma-separated severities provide OR within that severity list. Environment, server-name, and tag negation are not supported.

An explicit is:resolved or is:unresolved qualifier overrides the selected resolved/unresolved tab. The selected date range continues to apply to the results. Switching tabs removes the explicit resolution qualifier while preserving the rest of the query.

Find an Exact Occurrence

Paste an occurrence ID into the project search to find that exact occurrence. Telebugs accepts the 32-character form returned when a report is accepted and the standard hyphenated UUID form, regardless of letter case. Exact occurrence-ID search is limited to the current project and is not restricted by the selected date range.

Open the result to inspect the occurrence. This is useful when an application log, support report, or SDK callback includes an occurrence ID but not a Telebugs URL.

Previous-Period Comparisons

Open the date menu and select Compare with previous period to add the immediately preceding range to the dashboard. For example, Last 28 days compares with the 28 days before it. The date button shows vs. prev. while comparison is active, and totals display the direction and size of the change.

Telebugs aligns the two periods point by point, including partial current hours, so an in-progress period is not compared with a complete one. Release markers remain attached to the current period. Select the comparison item again, press X, or use the command palette to turn comparison off.

Comparison is available for bounded ranges. All time has no equally sized preceding period, so its comparison control is hidden. Changing to All time also clears an active comparison.

Chart Data and CSV Exports

The chart is the quickest way to spot spikes and changes over time. Select Expand chart for more vertical detail.

Select View data table when you need exact values, keyboard navigation, or a screen-reader-friendly alternative to the visual chart. The table follows the selected date range and includes both periods when comparison is enabled. Release links appear when a release marker falls within the displayed range.

With the table open, select Download CSV to export the same rows. The CSV contains the displayed timestamps, current values, previous-period values when enabled, and release labels. It uses the same filters as the chart, making it useful for spreadsheets, incident reviews, and sharing trend data outside Telebugs.

Keyboard Navigation

Use J / K or the arrow keys to move through the visible errors, and use O or Enter to open the highlighted error. Press X to add or remove the highlighted error from the bulk selection, or Escape to clear the highlight.

Press Command-K or Control-K to search errors, change the status or date filter, run applicable actions for selected errors, or navigate to another project or application.

See Keyboard shortcuts for the complete shortcut reference, custom assignments, favorites, and safety behavior.