Search and Manage Synthetic Tests

Overview

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

Synthetic Monitoring Tests page

By using facets, you can accomplish the following actions:

  • Search for specific Synthetic tests
  • Manage your tests with bulk actions

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.
TeamThe team responsible for responding to 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
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 facet.

Manage tests

Bulk actions

Manage your Synthetic tests in bulk by selecting one or more tests on the Synthetic Tests page and clicking Edit Tags, Run Tests Now, or Delete.

Test actions

Clicking on the kebab menu to the right of a test populates option icons such as Pause, Run Test Now, Edit Test, 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.

Synthetic test alerts in the Events Explorer

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