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 facility 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 Shared by ThousandEyes in the ThousandEyes UI by navigating to Manage > Sharing > Shared by ThousandEyes.

For a step-by-step guide on adding tests from Shared by ThousandEyes, see Getting Started with Network & App Synthetics Tests: Shared by ThousandEyes.

The Test Settings Page

To navigate to the Test Settings page, click Network & App Synthetics > Test 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 begin adding tests, select Network & App Synthetics > Test Settings in the left-hand navigation pane. The Tests Settings page appears, with the Add New Test section visible:

Highlighted areas on the page are documented in the following list:

1) Test Layer: Available test layers are shown in a ribbon at the top of the page. Only test layers which are available to your organization will be shown. Each category is documented in the section below entitled Test Details.

2) Test Type: Test types for the highlighted test layer.

3) Basic / Advanced Settings: This set of tabs allows you to toggle between Basic and Advanced test settings.

4) Agents: This drop-down lists the ThousandEyes Cloud Agents and Enterprise Agents available to your account. Select one or more agents to assign them to this test.

5) Alerts: When the Enable box is checked, the alert rules selected in the drop-down list will be active for the test. You can select alert rules with the drop-down list, and create, modify and delete alert rules with the Edit Alert Rules link.

6) Views Enabled for This Test: This panel shows which views will be available, given the current test type and configuration selections.

7) Projected Usage: This meter shows projections of the number of test units consumed once the test configured, as a percentage of the organization's monthly unit allotment. Two projected values are shown:

This Month: The percentage of the organization's current monthly unit consumption that will be used once this test is added

Next Month: The percentage of the organization's monthly unit consumption that will be used in a full month once this test is added.

See About Our Consumption Model regarding unit consumption.NOTE: The Projected Usage panel appears once the user selects one or more Cloud Agents from the Agents selector. Selecting Enterprise Agents will not cause the meter to appear.

NOTE: Some panels may not appear if your user account is not assigned a role with the appropriate permissions. Check your account's roles on the Profile tab of the Account Settings page. Other users' roles can be viewed on the Users tab. Check the permissions assigned to each role on the Roles tab. For more information on roles and permissions, see Role-Based Access Control, Explained.

Once you click Create New Test, the test is added and will begin collecting its first set of data.

Test Settings List

To view a list of all of your tests, navigate to the Network & App Synthetics > Test Settings > Tests Tab. If your account has at least one agent available, then the interface will show a list of tests configured under the account.

The image below shows a sample list of tests:

Each test entry in a list depicted above can be expanded. When expanded, the test's configuration is revealed. Here is an example of a page load test configuration:

A user with appropriate privileges can enable or disable any test listed under the account group. Disabling a test will not delete the test data, but the data will expire 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.

Clicking the ... icon shows you additional test options.

Customizing Test Settings List Columns

To customize the columns that appear in the test settings list, click the gear icon at the far right of the filtering options. From the right side panel that appears, select the columns that you wish to show in the test settings list. 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 listed in three ways, by searching for text, adding a filter, and selecting options from filter menus.

Filter Test Settings by Searching for Text

To filter by searching for text, type text into the search box. Matching tests are listed underneath. The left of the search box indicates how many tests matched out of the total number of tests.

Filter Test Settings by Adding a Filter

To add a filter, click the Add Filter button to the right of the search box. Select from the criteria to filter. Click the checkbox next to the items that match the criteria you want to filter on.

Filter Test Settings Using the Filter Menus

The filter menus are listed to the right of the search field and the Add Filter button. Supported options include, Type, Test Labels, Status, and Agents. Click on any menu to select values that match the criteria you want to filter on. The test settings list is automatically updated.

To view all tests without any filters, click the Reset Filters link.

Updating Tests

After a test is created, the settings of the test configuration can be updated. There are some exceptions; the table below lists the parameters that cannot be edited in specific test types:

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.

Advanced Test Configuration

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

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