Working with Test Settings
The ThousandEyes platform enables customers to test networked assets owned by the organization, and test SaaS-based assets to which the organization subscribes. This article describes how to create and manage tests.
This article covers creating tests in the following ways:
Templates
Shared by ThousandEyes
Test Settings
If you are new to the platform or unfamiliar with the type of test you need to create, use test templates and the Shared by ThousandEyes feature to create tests from scratch quickly. For information on templates, see Templates. For information on Shared by ThousandEyes, see Shared by ThousandEyes.
If you are already familiar with the ThousandEyes platform or have specific needs not covered by the more streamlined options above, you can create tests from scratch using the Test Settings page. For more information, see The Test Settings Page below.
For existing tests, use the Tests Settings page to manage test configurations. For more information, see Test Settings List.
For a step-by-step walkthrough on creating new tests, see Getting Started with Network & App Synthetics Tests.
Templates
The template workflow automatically creates test configurations from options you select. Templates can also create alert rules and dashboards.
To create tests using templates, see Tests: Onboarding.
Shared by ThousandEyes
The Shared by ThousandEyes page shows test configurations created by ThousandEyes and shared publicly that you can add to your account. These tests do not cost any additional units, making them great samples to build on and learn from. You can access the Shared by ThousandEyes page in the ThousandEyes UI by navigating to Manage > Sharing > Shared by ThousandEyes.
For a step-by-step guide on adding tests from the Shared by ThousandEyes page, see Getting Started with Network & App Synthetics Tests: Shared by ThousandEyes.
The Test Settings Page
To navigate to the Test Settings page, use the left-hand menu to navigate to Network & App Synthetics > Test Settings, or you can access Test Settings in the app with this link: https://app.thousandeyes.com/network-app-synthetics/test-settings/?tab=settings. This view lists the tests that have been configured in the current account group. If there are no tests configured, this list will be empty.
Adding Tests
To add a new test:
Navigate to Network & App Synthetics > Test Settings.
Click the + Add New Test button at the top right of the screen. Note: If you do not see the + Add New Test button, you do not have sufficient permissions to create tests. Reach out to your organization's administrator for assistance.
The Quick Create menu appears with options for creating tests:
If you are new to ThousandEyes and you're not sure where to start, select from the ThousandEyes recommendations section, such as Associated Service Recommendations.
If you want to create dashboards and alerts in addition to creating tests, select from the Templates section. To learn more about Templates, see Templates.
If you want to configure tests for specific targets or services, such as HTTPS, DNS, or APIs, select the test type from the list.
Follow the step-by-step instructions and configure your tests by entering the necessary data into the provided fields. The instructions will show you how to deploy your test once you are finished.
Once deployed, your test is listed on the Test Settings page.
Note: Some test settings configuration screens report projected usage of units. For more information about unit consumption, see About Units.
For more information on roles and permissions, see Role-Based Access Control, Explained. You can check your account's roles on the Profile tab of the Account Settings page. You can access Account Settings in the app with this link: https://app.thousandeyes.com/settings/account Other users' roles can be viewed on the Users tab. Check the permissions assigned to each role on the Roles tab.
Adding Tests Manually
To configure tests manually, refer to the specific documentation for the test types listed below. To learn more about test types, see Tests.
Network Layer Tests: Network Tests
Routing Layer Tests: BGP Tests
DNS Layer Tests: DNS Tests
Web Layer Tests: Web Layer Tests
Voice Layer Tests: Voice Tests
Test Settings List
To view a list of all of your tests, navigate to Network & App Synthetics > Test Settings or access it directly at https://app.thousandeyes.com/network-app-synthetics/test-settings/?tab=settings. That opens the Tests page with the Tests tab selected. If your account has at least one agent available, the interface shows a list of tests configured under the account.
Customizing Test Settings List Columns
To customize the columns that appear in the test settings list, click the gear icon at the top right of the table. From the panel that appears, select the columns you wish to show. You can also reorder the columns by dragging them up or down. Click Save to apply the changes.
Filtering Tests
You can filter the tests in the list by searching for text or by using the filter menus.
Filter Test Settings by Searching for Text
To filter by searching for text, type text into the search box. The list automatically updates to show matching tests. The left side of the search box indicates how many tests matched out of the total number of tests.
Filter Test Settings Using the Filter Menus
The filter menus are located next to the search field. Supported options include Type, Tags, Status, Agents, and Interval. Click any menu to select values that match the criteria you want to filter by. The test settings list automatically updates.
You can also use the Tags filter to quickly find all tests associated with a specific tag (for example, finding all tests tagged with Env: Demo).
To view all tests without any filters, click the Reset filters link.
Updating Tests
To update an existing test, from the test settings list, click on the name of the test. This opens the manual test settings page. For more information on using the manual test settings page, see the section Adding Tests Manually.
Some fields cannot be edited after the test has been created:
BGP
Prefix
Transaction
Target
You can also enable or disable tests by clicking the toggle under the Status column. Note that a user with appropriate privileges can enable or disable any test listed under the account group. Disabling a test does not delete the test data, but the data expires on a daily rolling basis. See How Long Does ThousandEyes Retain Customer Data? for more information about data retention periods. Disabled tests do not consume units.
Updating Multiple Tests
From the Tests tab, select the checkbox for each test that you want to update. You can use search and filters, such as Type, Status, Agents, and Interval, to narrow the list before you select tests.
Bulk actions let you update many tests in one job instead of opening each test. They support only the actions listed in the table: Enable, Disable, Delete, Test Interval, and Manage Agents.
After you select tests, the bottom toolbar shows the selected count and action buttons. Use the table below to choose the right action.
Enable
Enable
Turns on the selected tests.
These tests should start running now.
Job details show which tests were updated or failed.
Disable
Disable
Turns off the selected tests.
These tests can stop running without affecting coverage.
Job details show which tests were updated or failed.
Delete
Edit > Delete
Deletes the selected tests.
You no longer need these test configurations.
Job details show which tests were deleted or failed.
Test Interval
Edit > Test Interval
Changes how often eligible tests run.
Review warnings for tests that do not support the interval.
Job details show which tests were updated or failed.
Manage Agents
Edit > Manage Agents
Adds or removes assigned agents.
Review agent changes for each test.
Job details show agent updates and any failures.
Bulk updates are submitted as jobs. After a job is submitted, the panel shows Changes submitted. and View Job.
Reviewing Bulk Update Job Results
Select View Job after you submit a bulk update.
The Job Details panel opens. It shows the job status, job ID, how many tests have been processed, the tests in the job, and the change type. Bulk interval jobs use Test Intervals Edited. Bulk agent jobs use Agents Updated.
Review the job status.
The job status can be Submitted, In progress, Completed, or Cancelled. If Cancel Job is available for a submitted or in-progress job, use it only when the remaining tests should not be processed. The cancellation dialog says that remaining tests will not be processed and that the action cannot be undone.
Review failed tests after the job completes.
If one or more tests fail, open Failed tests. The table shows Test name and Message. A failed test is not updated, and processing continues for the remaining tests.
Changing the Test Interval for Multiple Tests
Use Test Interval when selected tests should use the same interval. Bulk interval changes follow the same interval limits as individual test settings. If a test cannot use an interval on its own, bulk editing does not make that interval available for that test.
Select the tests that you want to update.
Select Edit > Test Interval.
The right-side panel opens. The title shows how many eligible tests are included, such as Edit Test Interval for 2 Tests.
In Interval, select the interval that you want to apply.
The choices are radio buttons. The list can change based on the selected test types, so use the options shown in the panel.
Review any warning at the top of the panel.
If a warning appears, open its details before you submit. The warning shows which selected tests are not eligible for the interval change or do not support the selected interval.
Select Edit Interval.
Managing Agents for Multiple Tests
Use Manage Agents when selected tests need the same agent assignment changes. The workflow compares the current agent assignments across the selected tests and lets you add or remove agents in one job.
Select the tests that you want to update.
Select Edit > Manage Agents.
The Manage Agents dialog opens. The title shows how many eligible tests are included, such as Manage Agents for 2 tests.
Use the Basic or Advanced view and the Enterprise Agents or Cloud Agents tabs to find agents.
Depending on the selected tab and view, use search, filters such as IP Support and Countries, Group By options such as Your tags, Location, and Provider, Show: All / Selected, Select All, Collapse all, expandable agent groups, individual agent checkboxes, and the map.
Update the agent selections.
A checked agent is assigned to all eligible selected tests. A partial selection means the agent is assigned to some selected tests, but not all of them. An empty checkbox means the agent is assigned to none of the eligible selected tests after the update. Leave a partial selection unchanged to keep the current assignments, select it to add the agent to all eligible tests, or clear it to remove the agent from tests where it is assigned.
The footer shows the selected agent count and the Enterprise and Cloud breakdown. If Update is unavailable, no agent assignments changed.
Select Update.
In the confirmation dialog, review the Summary of changes and the per-test table.
The table shows Agent name, Test name, and Action. Use Modify Agents if you need to change the selection. If a warning lists tests that are not eligible to manage agents, those tests are not processed in this batch.
Select Confirm.
Deleting Tests
To delete a test, click ... to the far right of test setting row, and select the Delete menu option.
The deleted tests are available to be recovered for 31 days after deletion. To see a list of deleted tests, click on the Status filter menu and select the Deleted checkbox. Deleted tests show up in the test settings list with a line striking through the displayed text.
To recover a deleted test, click ... to the far right of the test setting row, and select the Recover menu option.
Duplicating Tests
To duplicate a test, click ... to the far right of test setting row, and select the Duplicate menu option. You can manually configure the new test using the existing values from the test you chose to duplicate. For more information on using the manual test settings page, see the section Adding Tests Manually.
Related Articles
To learn more about ThousandEyes metrics, see ThousandEyes Metrics: What Do Your Results Mean?.
To understand how a test results can be shared, visit Sharing Test Data
Last updated