Search and Manage Synthetic Tests

Overview

Search, access, and manage all of your tests on the Synthetic Tests page or the CI Results Explorer.

Quickly find the tests that matter to you using facets, get an overview of the state of your application with the global uptime and response time graph, and manage your tests through bulk functionalities.

For more information about the CI Results Explorer, see the CI Results Explorer documentation.

Search

Facets and tags

The Synthetics Filters panel on the left side of the page lists several default facets you can use to search through your tests. Default facets include:

Create your query

Search through your Synthetic tests by clicking on the facets on the left panel or by writing your own custom query using the search bar. As you select and deselect facet values in the panel or in the search bar, the search bar will automatically update with the equivalent query. Likewise, when you modify the search bar query (or write one from scratch), the facets checkboxes update to reflect that change. Query results update in real-time as you edit the query; there’s no Search button to click.

• Search on free text: Enter your text in the search bar to search on a test name.
• Search on a single facet: Click a facet value to create a search query that includes only that facet value. For example, type:api. To add another value of the same facet to your search, click the other value checkbox or add the other value with an OR Boolean operator and wrap values with quotes and parentheses. For example, type:("api" OR "api-ssl").
• Search on multiple facets and text: Click on values of different facets to create a search query that includes filtering for multiple facets. For example, type:api``region:aws:us-east-2. You can also mix facets and text. For example, checkout type:browser. Although invisible, the AND Boolean operator is applied when searching on multiple terms.
• Search on message: Use message in your query to search through your tests’ notification messages (found in the Message property). For example, message:testcontent.
• Exclude facets or text: Click on an existing filled checkbox to deselect a facet value or prepend your term with - to exclude it from the search query, e.g. -state:paused.
• Perform custom matches: Use wildcards (*). For example, valid*.

If you want to exclusively search for browser tests, click Browser Test in the left panel. Click again to reselect all your tests, regardless of their type.

Manage tests

Bulk management

Bulk manage your Synthetic tests from the list page by clicking multiple individual test checkboxes in the table or by clicking on the checkbox next to State to select all the test checkboxes of the page. Once selected, choose Run Tests Now or Delete, which will bulk run or delete all of the selected Synthetic tests.

Action tray options

Hover over a test in the table to populate options such as Pause, Run Test Now, Edit, Clone, and Delete. The option Edit Recording is also available for browser tests.

Audit events

The creation, addition, and deletion of Synthetic tests, global variables, and private locations create events in the event stream. Generated events explain the change and display the user who performed the change.

Find all Synthetic Monitoring related changes by searching the event stream for #audit synthetics. Retrieve changes that were done on a specific test by searching on the id of your test. For example, tags:public_id:4m7-bqy-mxq.

Further Reading

Additional helpful documentation, links, and articles:

Getting started with Synthetic MonitoringDOCUMENTATION Best practices for creating end-to-end testsBLOG Best practices for maintaining end-to-end testsBLOG CI Results ExplorerDOCUMENTATION