Searching for requests

You can view a list of individual requests that have been tagged with signals and that fit into the all or sampled data storage category. This guide describes the different search functionality and search syntax you can use to narrow this list.

Filtering

You can use filters to find requests that meet specific criteria. Selected values auto-populate in the search bar where you can further modify the query.

Search bar

You can enter free-text and explicit queries into the search bar to find requests that meet specific criteria. Explicit queries follow the <key><operator><value> syntax, where:

• the key is the field to search upon.
• the operator defines the relationship of the key to the value.
• the value is the specific value used to filter the requests list.

Example free-text and explicit queries are as follows:

Keys

The keys that you can search on are as follows:

Operators

When using operators, keep in mind the following:

• All values below can be quoted to allow for spaces.
• Adding - (minus) before any key negates the operation.
• Different key names function as an AND operator (from:-1h path:/foo).
• Multiple keys with the same name function as an OR operator (path:/foo path:/bar should return paths matching either /foo or /bar).

Supported operators include:

Time

Time ranges can be specified in a number of ways using the from and until keys.

Queries on the Requests page are limited to a maximum time range of 7 days. Queries greater than a 7 day period will not yield any results. For example, if you wanted to find results from 2 weeks ago, your query would need to use from:-21d until:-14d, which would be a 7 day window. A query of just from:-21d would not yield any results as that would be a 21 day window.

Relative time

Example:

• from:-5h (until now)
• from:-5h until:-4h (one hour range)

Absolute time

Absolute time is also allowed using

• Unix UTC Seconds Since Epoch
• Java/JavaScript UTC Milliseconds since Epoch
• ISO Date format YYYYMMDD

Example Absolute Time: Unix UTC Seconds

• from:141384000 (until now)
• from:141384000 until:1413844691

Example Absolute Time: Java/JavaScript Milliseconds UTC

• from:141384000000 (until now)
• from:141384000000 until:1413844691000

Example Absolute Date: YYYYMMDD

• from:20141031 (until now)
• from:20141031 until:20141225

You can also mix and match time formats:

• from:20141031 until:-1h

Query builder

The Query builder lets you filter for requests with a specific combination of tags (e.g. NOUA) and HTTP status codes (e.g. 404, 500).

To filter results using the Query builder:

1. Use the Time menu to specify a time range for when requests were sent.

2. Click Query builder.

3. From the Tag and HTTP Code tabs, select the combinations of tags and codes you want to filter on. Your selections are populated in the search bar.

   Click Select All on either tab to select all tags or all HTTP codes. Click Clear selection on a given tab to clear selections on that tab or Clear all to clear all Query builder filters.

4. Exit the Query builder.

5. Click Search.