Filtering

Filter your error reports using the filter bar.

The filter bar provides a powerful way to find relevant errors in your dashboard by selecting one or more filter keys and date ranges.

The filter bar automatically updates as you navigate the dashboard to show you the filter keys and date range that corresponds to your current view.

Some filter keys support wildcard or pattern matching, while the date range fields support a flexible syntax.

Exclude filters can be used to remove a subset of errors and events from the view.

Using the filter bar

Bugsnag provides a filter bar near the top of the screen on each page that allows you to filter your error data.

Filter bar

  • To apply a filter, click in the filter bar or use the keyboard shortcut /. An auto-complete dropdown will appear where you can select your desired filter.

Adding a filter to the Filter bar

  • Apply date filters from the right hand side of the filter bar. Select a preset period (1h, 3h, 7d, 30d, all) or click on the start or end date range value and type a numeric or textual date. See the supported date formats.

Adding time or date filter to the Filter bar

  • Filter to versions or version ranges using the ‘seen in release’ and 'introduced in release’ filters.

    • Use the 'latest’ filter to show the most recent release across all your release stages. Add a release stage filter to show the most recent release on that stage.
    • Use wildcards to show a range of releases. For example 1.* will show errors from all your version 1 releases.
    • Select 'before’ or 'since’ to show versions that were released before or after the filter. For example 'before’ 1.0.0 will show errors from all versions that were released before 1.0.0 regardless of their version number or name. Note that wildcards are not supported with 'before’ and 'since’.
    • For Android and iOS apps where there are multiple version numbers you can filter by either or both. For example an Android app with a versionName of 1.0.0 and a versionNumber of 1 is displayed as 1.0.0 (1) and can be filtered by using 1.0.0, 1 or 1.0.0 (1).
  • Add multiple filters to compose complex queries. Filters for different fields will show errors that match all of the distinct filters (boolean AND). Filters for the same field will show errors that match any of the provided values (boolean OR).

    For example if you filter on both user email: test.com and browser: firefox you will see errors that were experienced by people with a test.com email address that are using Firefox.

    Performing an AND search

    If you then added another browser filter browser: chrome you would see all errors that were experienced by people with a test.com email address while using Firefox or Chrome.

    Performing an OR search

  • Exclude errors by selecting 'does not match’ when adding a filter value.

    Exclude filter

Default filter fields

The following fields in your error reports are available to use in the filter bar. If you want to filter on something that is not listed below you check out our documentation on custom filters.

Key Searches on Pattern(s) matched Example(s)
User ID User ID of user(s) affected by an event Exact match only
User email Email address of user(s) affected by an event Supports substring matches bugsnag.com, gmail, jean.bartik@hostname
User name User name of user(s) affected by an event Exact match only Adele Goldberg
Error status The state of the error in Bugsnag Exact match only Open, snoozed, fixed
Error assigned to Collaborator the error is assigned to “Me”, “anyone”, or exact match Me, Anyone, Frances Spence
Error has linked issue True/false flag for linked issue Exact match only
Release stage Production, staging, development, etc. Exact match only
Context Action happening when the event occurred Exact match only
App type Type of app running when the event occurred Exact match only Worker, server
Introduced in release Release/version the error was first seen in Supports wildcards 1.0.0, 1.*, 1.?.0
Seen in release Release/version the event occurred in Supports wildcards 1.0.0, 1.*, 1.?.0
Error class The error class of an event Supports substring matches
Error message The error message of an event Supports substring matches
Filename Filenames in the event stacktrace Exact match only
Method Methods in the event stacktrace Exact match only
Severity Error, warning, or info Exact match only
Unhandled Whether the event was unhandled Exact match only True, False
Browser The browser associated with the event Exact match only Chrome, Firefox, Safari, Opera, etc.
Browser version Browser version the event occurred in Supports wildcards: 1.*, 1.?.0 45.0.2454.101 (Chrome), 40.0.3 (Firefox)
OS Operating system the event occurred in Exact match only OS X, Windows, iOS, Ubuntu
OS version Operating system version the event occurred in Supports wildcards: 1.*, 1.?.0
Hostname Hostname the event occurred in Exact match only staging1, sidekiq
Device manufacturer Manufacturer of the device the event occurred on Exact match only
Device model Model of the device the event occurred on Exact match only
Request URL URL of the request that caused an event Exact match only https://api.example.com/users/
Request IP IP address of the request that caused an event Exact match only 184.23.0.55, 73.158.138.90

Don’t see what you want to filter on here? Check out our documentation on custom filters.

Bookmarking filters

Once you have added a set of filters to the filter bar you can easily save the state of the filter bar so that you can access it again at any time. To do this you click the 'star’ icon on the right hand side of the filter bar. You can choose a name for a bookmark and make it the default for the project if desired.

Saving a new filter

Bookmarks are displayed on the left hand side bar. Selecting one will apply the bookmarked filters.

Viewing saved filters

Saved filters are specific to you so setting the default for the project will not affect your collaborator’s filters.

Supported date formats

We use SugarJS to give you a flexible syntax for setting a date or date range filter. The following date formats are supported in the date and date range fields of the filter bar:

  • 2012
  • 2012-06
  • 2012-06-20
  • 06-20-2012
  • 06/20/2012
  • 06.20.2012
  • 2012/06/20
  • 20 June 2012
  • 2010-05-25T16:30:50.180Z
  • 2010-06-20T16:30:50.180+02:00
  • Wednesday, June 20th, 2012
  • 3 days ago
  • Yesterday
  • One week ago
  • A month ago
  • The end of the month

For an expanded list of date formats, see the SugarJS date syntax documentation.