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"