Overview

Synthetic Monitoring Test Suites let you organize multiple tests into a single collection for simplified management and troubleshooting. Group tests by user journey, environment, location, service, team, or any other dimension that fits your workflow. View aggregated results, identify failing components, and understand application performance across related tests, all from a unified view.

Key features

• Centralized visibility: View all tests in a suite and their results in one place.
• Simplified management: Create and run test groups instead of managing individual tests separately.
• Easier maintenance: Identify which tests need updates when application changes are made.

Create a test suite

To create a new Test Suite:

1. In Datadog, navigate to Digital Experience > Tests.
2. Click New Test > New Test Suite.
3. Optionally, navigate to the Synthetic Monitoring tests page, and click + New Suite.

Test suite configuration

1. Enter a name for your suite (for example, Checkout flow or API health checks).
2. Click Add Tests to include existing Synthetic Monitoring tests.
   You can:
   • Search by name or tag.
   • Filter by test type (such as Browser, API, Private Location, or Mobile).
   • Select one or more tests to include.
3. Click Add Selected Tests to confirm.
4. Optionally, remove tests using the Remove Test from Suite icon next to each entry.
5. Click Save suite when finished.

View and manage

After creating your suite, it appears in the Suites tab on the Synthetic Monitoring tests page, or you can access test suites from Digital Experience > Test Suites. Click on a test suite to display the following:

• A summary of test results (success, failures, skipped).
• Execution details such as timing, environment, and test type.
• Filters to refine by location, time frame, or tag.
• Drill-down links to individual test runs for deeper investigation.

You can sort or search within the suite to focus on failing or recently updated tests. Use the View All option to visualize the aggregated performance of all included tests.

Note: Test runs appear in the suite only from the date the test was added. To view earlier results, check the individual test page. If you rename a test, previous runs remain listed under the original name. A maximum of 300 tests can be added per suite.

Troubleshooting

If some tests fail to appear in a suite:

• Ensure the tests are active and not deleted.
• Confirm you have the necessary permissions to view those tests.
• Refresh filters or clear search terms when adding tests.

If execution results look incomplete:

• Verify test run frequency and recent activity.
• Check for tag or location mismatches that could filter out runs.
• Re-save the Test Suite to refresh the association with its tests.

Further Reading

Additional helpful documentation, links, and articles:

Learn about Synthetic MonitoringDOCUMENTATION Configure Synthetic test monitorsDOCUMENTATION Synthetic Monitoring TroubleshootingDOCUMENTATION