Search and Manage Synthetic Tests

Overview

You can search, access, and manage all of your tests on the Synthetic Tests page.

To better understand the state of your application, click Show Metrics. The Overview Metrics section appears with graphs about your overall tests’ uptime and response time. For more information about the data displayed, see Synthetic Monitoring Metrics.

You can use facets to find Synthetic tests, manage your tests with bulk actions, and monitor events to track changes to your Synthetic Monitoring configuration. Explore out-of-the-box Synthetic dashboards to better understand your testing coverage.

Search for tests

Facets and tags

The Synthetics Filters panel on the left lists default facets you can use to search for your tests.

The default facets include the following:

FacetDescription
TypeThe type of Synthetic test: browser, api, api-multi, api-websocket, api-ssl, api-dns, api-tcp, api-udp, api-icmp, or api-grpc.
StatusThe Synthetic test status: OK, Alert, or No Data.
CreatorThe creator of the Synthetic test.
RegionThe managed and private locations the Synthetic test is running from.
StateThe state of the Synthetic test: live or paused.
NotificationThe handle used by the Synthetic test for notifications.
EnvThe environment the Synthetic test is running on.
CI/CD Execution RuleThe status of the test run: Blocking, Non-blocking, or Skipped.

The Tags panel below Synthetic Filters lists several default tags you can use to identify your tests.

The default tags include the following:

TagDescription
TeamThe team responsible for responding to the Synthetic test.
TagThe tag assigned to the Synthetic test.
ServiceThe service the Synthetic test is running on.
Private LocationsWhether or not private locations are enabled: true or false.

For more information, see Using Tags.

Create a search query

Search for tests by clicking on the facets to the left or by writing your own custom query in the search bar. As you edit the query, your search results update in real time.

When you select and deselect facets, the search bar automatically reflects your changes. Similarly, you can modify the search bar query or write a query from scratch in the search bar to select and deselect the facets on the left.

  • 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 on an additional value’s checkbox. You can also add the additional value with an OR Boolean operator and wrap the values using quotes and parentheses. For example, type:("api" OR "api-ssl").
  • Search on multiple facets and text: Click on facet values from different facet types to customize a search query that filters 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: Add a message to create a search query that filters on your tests’ notification messages configured in the test monitor. For example, message:testcontent.
  • Exclude facets or text: Click on an already-filled checkbox to deselect a facet value or prepend a term with - to exclude it from the search query. For example, -state:paused.
  • Perform custom matches: Use wildcards (*). For example, valid*.

To search on a type of Synthetics test, select the test type under the Type variable.

Manage tests

Batch actions

Manage your Synthetic tests in bulk by selecting multiple test checkboxes in the list on the Synthetic Tests page. Click Run Tests Now or Delete to bulk run or delete the Synthetic tests you selected.

Test actions

Hovering over a test populates option icons on the right such as Pause, Run Test Now, Edit, Clone, and Delete. The Edit Recording option is available for browser tests.

Track events

Creating, adding, and deleting Synthetic tests, global variables, and private locations generates events in the Events Explorer. Events describe changes that occurred and display the users who performed the changes.

Find all Synthetics-related changes by searching for your test monitors’ alerts in the search bar, or by selecting an event type under the Event template variable. For example, Event Type:synthetics_alert.

Further Reading