and exceptions).

When searching on Event properties within the Issues search, Issue Search will return any Issue that has one or more events matching the supplied event filters.

Below is a list of Event-level tokens reserved and known to Airlock:

geo.country_code, geo.region, geo.city

Restrict results to events triggered by a geographic area.

release

Restrict results to events tagged with the given release.

Exact match on the version of a release.

user.id, user.email, user.username, user.ip

Restrict results to events affecting the given user.

event.timestamp

Restrict results to events that occurred at the given timestamp. This filter can be passed twice to provide a range.

Events occurred on January 2, 2016: event.timestamp:2016-01-02

Events between 01:00 and 02:00 (UTC):

event.timestamp:>=2016-01-02T01:00:00 event.timestamp:<2016-01-02T02:00:00

The following comparative operators are available:

device.arch, device.brand, device.locale, device.model_id, device.orientation, device.uuid

Restrict results to events tagged with a specific device attribute.

os.build, os.kernel_version

Restrict results to events tagged with a specific operating system property.

stack.abs_path, stack.filename, stack.function, stack.module, stack.stack_level

Restrict results to events with a matching stack property.

Custom Tags

Additionally, you can use any tag you’ve specified as a token. Tags are various key/value pairs that get assigned to an event, and you can use them later as a breakdown or quick access to finding related events.

Most SDKs generally support configuring tags by configuring the scope:

JavaScript

Airlock.configureScope(function(scope) {
                scope.setTag("page_locale", "de-at");
});

Several common uses for tags include:

Premade Searches

Premade searches are common search terms that we think you’re likely to use. The premade searches will appear in the order of which you’ve most recently used them.

Pinned Searches

You can pin a search, and it will become the default view you see on your Issues view. The pinned search is only visible to you and is relevant across your groups.

  1. Type a search into the search bar.
  2. Click the pin icon next to that search.
  3. Once pinned, Airlock will add the search to the Saved Search Dropdown. The search label in the text will read: My Pinned Search.

To change your pinned search, do the following:

  1. Select your pinned search. Un-click the pin icon. Your default search will return to is:unresolved.
  2. Do another search. Click the pin icon. The query listed as ‘My Pinned Search’ will now be the new pinned query, instead of the original one.

You can pin a premade search the same way you pin any other search. When you’ve selected a premade search, and the premade search query populates the search bar, pin it.

Organization Wide Saved Searches

Owners and managers can create a persistent view for their organization by creating custom saved search. These saved searches will not be associated with a specific group, but with all groups (and users) across the org.

  1. Type a search into the search bar, then click the “add to Organization filter list” icon just to the right of it. Keeping in mind that you need to be an owner or manager within the org to use this feature.
  2. Name the search in the resulting modal and click ‘Save.’
  3. The view will then become part of the saved search dropdown.

When an owner or manager hovers over a custom saved search, they should see a trash can icon. The trash can icon functions exactly like you might expect, and removes the custom saved search from the dropdown.