Synthetic test execution types

Synthetic tests support two execution types Scheduled and On-demand. The On-demand execution type is introduced to support more flexible test runs. This capability is useful for development, testing and troubleshooting. For example, after you apply a backend fix, you can immediately run the test to verify that the issue is resolved.

A Scheduled Synthetic test runs based on the test run frequency, as managed by the Synthetic PoP. To create a Scheduled Synthetic test, follow the steps in Creating a scheduled test.
An On-demand Synthetic test runs 30 seconds after the Synthetic PoP receives it, regardless of the test run frequency. You can only create an On-demand Synthetic test if a Scheduled Synthetic test already exists.

Creating an On-demand test

To create an On-demand Synthetic test, complete the following steps:

Make sure that at least one Scheduled Synthetic test already exists.
Make sure that you have the necessary permission setting.
Create an On-demand Synthetic test based on an existing test by using the Create a Synthetic test CI/CD OpenAPI or the synctl command.

View On-demand test results

To view On-demand test results:

Go to Synthetic Monitoring > Tests.
Select the corresponding scheduled Synthetic test.
Go to the Results page and sort by Execution type. Results marked as non-scheduled are from the On-demand execution type.

The Tests and Summary pages only show the aggregated metric data from Scheduled execution type data.

View On-demand tests

You can view On-demand Synthetic tests in the following ways:

To view a list of On-demand Synthetic tests, you can use the Get all Synthetic test CI/CD OpenAPI or the synctl command.
To view a specific On-demand Synthetic test, you can use the Get the Synthetic test CI/CD identified by test result ID or the synctl command.