Custom filters

Filter error reports using custom error properties.

Custom filters allow you to search for events by custom metadata you’ve added to your error reports. You can also add a pivot and summary when you add a custom filter to see the distribution of data across custom dimensions. This feature is available on our Pro plans and is available to trial today!

Creating a new custom filter

The easiest way to add a new custom filter is from the dashboard.

  1. While viewing an event report, click the Add Custom Filter icon:

    Add custom filter from the dashboard

  2. Choose a filter display name. This is the name you’ll use to find your custom filter in the filter bar.

    Create custom filter

  3. You can also configure additional advanced settings by clicking “Show advanced settings…”

Using custom filters

All custom filters you create will be available from the filter bar. This will allow you to search for events that match specific values of your custom data.

You’ll also see an option to click custom data in your event reports and add it as a filter, if you’ve indexed a top-level key with a value that is a string, number, or boolean:

Use custom filter icon

Managing custom filters

  • Custom filters can be managed from Project Settings -> Configure custom filters.

  • To create a new custom filter, click “Add Custom Filter”. To edit an existing custom filter, click on it in the list view.

    Add custom filter

  • Editing a custom filter provides the following options, you can find out more about these in our advanced custom filters documentation.

    Edit custom filter

  • To delete an existing custom filter, click on it in the list view and click “Delete this filter…” in the edit modal.

Exceptions to these guidelines:

  • It is not possible to create a custom filter for any data that is already filterable using the default filters.
  • For structured data in the Request tab you can create custom filters for specific headers or params. To do so, follow the guidelines above, but substitute request in place of metaData. Some examples:
    • request.headers.Host
    • request.params.controller

Additional Details

  • Values up to 255 characters long will be indexed. If a value is longer than 255 characters, the first 255 characters will be indexed.
  • Custom filters can only used for exact match filtering, not substring matching.

Please contact us for help configuring custom filter paths.