Searching for errors and occurrences

Within the application, you can search for errors using the search bar at the top of the project errors page. By default, the search query will be is:unresolved, showing you the errors that are not resolved.

When opening an error, the error occurrences can also be searched. You'll open the search bar by clicking the 'show occurrences' button on an error.

We provide a dozen search directives like these to help you find errors and occurrences. Some of them even provide suggestions for subjects to search for.

Not sure what directives can be used? By pressing CTRL-TAB, a handy autocomplete will show up.

Some directives can only be used with the error search, some only with the occurrence search, and some with both. This will be indicated in the directive description.

Search directives

Please note the values of directives cannot contain spaces. You can wrap the query with double quotes if you want to search for a value with spaces.

class - errors/occurrences

This directive allows you to search for the class name of the error or occurrence.

class:QueryException -> filters all QueryException errors or occurrences

command - errors/occurrences

It is possible to filter errors or occurrences triggered within commands:

• command:db:seed -> filters all errors or occurrences triggered within the db:seed command
• command:"db:seed --class=UsersTableSeeder" -> always wrap commands with spaces in double quotes

env - errors/occurrences

Filter errors or occurrences by environment:

env:production -> filters all errors or occurrences triggered in the production environment

first_seen_at - errors

Allows you only to show errors first seen at a specific time.

first_seen_at:2020-05-16 -> filters all errors which were first seen on May 16th, 2020

It is also possible to extend the directive for a more fine-grained search:

• first_seen_at:>2020-05-16 -> errors seen after May 16th, 2020
• first_seen_at:>=2020-05-16 -> errors seen on or after May 16th, 2020
• first_seen_at:<2020-05-16 -> errors seen before May 16th, 2020
• first_seen_at:<=2020-05-16 -> errors seen on or before May 16th, 2020

A timestamp in UTC can also be provided:

first_seen_at:>2020-05-16T12:00:00 -> filters all errors which were first seen after May 16th, 2020 at 12:00:00 UTC

is - errors

• is:unresolved -> only unresolved errors will be shown
• is:resolved -> only resolved errors will be shown
• is:unsnoozed -> only unsnoozed errors will be shown
• is:snoozed -> only snoozed errors will be shown
• is:recent -> only errors which were seen in the last 24 hours will be shown

job - errors/occurrences

Filter errors or occurrences by the job that triggered them.

job:App\Jobs\DownloadVideo -> filters all errors or occurrences triggered by the DownloadVideo job

language - errors

Filter errors by programming language (PHP or JS).

language:PHP -> filters all PHP errors

last_seen_at - errors

Allows you only to show errors that were last seen at a specific time.

The rules for this directive are the same as for the first_seen_at directive.

level - errors

Filter log messages by level.

level:warning -> filters all log messages with a warning level

tracking_uuid - errors/occurrences

Each error occurrence has a unique tracking UUID. You can use this directive to filter errors or occurrences by this UUID.

tracking_uuid:f3b9c1b0-7b1f-11ea-8d77-0242ac130003 -> filters all errors or occurrences with this tracking UUID

type - errors/occurrences

Filter errors or occurrences by the type of entry point which triggered them.

• type:web
• type:job
• type:command

url - errors/occurrences

Filter errors or occurrences based upon which URL they were triggered on.

url:https://flareapp.io -> filters all errors or occurrences triggered on the Flare website

user_id - errors/occurrences

Filter errors or occurrences triggered by a user specified by its id,uuid, or ulid.

user_id:1 -> filters all errors or occurrences triggered by the user with id 1

user_email - errors/occurrences

Filter errors or occurrences triggered by a user specified by its email address.

user_email:[email protected] -> filters all errors or occurrences triggered by the user with email [email protected]

version - errors/occurrences

When you send an application version to Flare, you can filter errors or occurrences by this version.

version:2.0.0 -> filters all errors or occurrences which were triggered on version 2.0.0

Without search directives

You're not always required to specify a directive. It is possible to type a search query with or without any directive, and Flare will search for the query in the error message, class, and entry point when searching for errors. When searching for occurrences, Flare will only search in the error message.

These queries without directives have some operations which allow for some more query finetuning:

Wildcard: *

This will match any letter or number.

Redis* -> Will match RedisException and Redis

Exact word: +

By adding a plus at the beginning of a word, you can force the search to match the word exactly.

+sync -> will match sync, but not async

Exclude: -

Minus will exclude the word from the search query. (note: another word should already be present before this operator can be used).

connection -mysql -> will match errors with connection in it but not MySQL

Exact phrase: "

By wrapping a sentence in double quotes, you can search for an exact match.

"Connection refused" -> will match errors with this exact sentence.

Which in the end, allows you to construct queries like this:

is:unresolved is:unsnoozed "Connection refused" -> will match all unresolved and unsnoozed errors with the sentence "Connection refused"