# Working with Test Settings

{% hint style="info" %}
The Labels feature has been upgraded to **Tags**. All your existing labels have been automatically migrated to the new tagging system with no action required on your part. Existing labels were converted to a tag key with an empty value (for example, a label named `subnet-10` is now a tag with the key `subnet-10` and no value). You can now manage all tags centrally by navigating to **Manage > Tags**.
{% endhint %}

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](#templates). For information on **Shared by ThousandEyes**, see [Shared by ThousandEyes](#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](#the-test-settings-page) below.

For existing tests, use the **Tests Settings** page to manage test configurations. For more information, see [Test Settings List](#test-settings-list).

For a step-by-step walkthrough on creating new tests, see [Getting Started with Network & App Synthetics Tests](https://docs.thousandeyes.com/product-documentation/getting-started/getting-started-with-cloud-and-enterprise-agent-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](https://docs.thousandeyes.com/product-documentation/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**.

{% hint style="info" %}
The **Shared by ThousandEyes** page is available to organizations in the US1 [data residency region](https://docs.thousandeyes.com/product-documentation/user-management/user-activity/thousandeyes-multi-region-cloud-support) only. It is not available in other data regions.
{% endhint %}

For a step-by-step guide on adding tests from **Shared by ThousandEyes**, see [Getting Started with Network & App Synthetics Tests: Shared by ThousandEyes](https://docs.thousandeyes.com/product-documentation/getting-started/getting-started-with-cloud-and-enterprise-agent-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:

1. Navigate to **Network & App Synthetics > Test Settings**.
2. Click the **Start Monitoring** button at the top right of the screen. **NOTE:** If you do not see the **Start Monitoring** button, you do not have sufficient permissions to create tests. Reach out to your organization's administrator for assistance.
3. The **Start Monitoring** page appears with three options for creating tests:
   1. 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**.
   2. 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](#templates).
   3. If you want to configure tests for specific targets or services, such as HTTPS, DNS, or APIs, select from the **Monitor a specific site or service** section.
4. 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.
5. 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 Our Consumption Model](https://docs.thousandeyes.com/product-documentation/user-management/usage-and-billing/about-our-consumption-model).

For more information on roles and permissions, see [Role-Based Access Control, Explained](https://docs.thousandeyes.com/product-documentation/user-management/rbac/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

{% hint style="warning" %}
Note: The user interface for Test Settings is being updated. The information on these pages may not reflect the new experience. The documentation will be updated shortly to align with these improvements.
{% endhint %}

To configure tests manually, refer to the specific documentation for the test types listed below. To learn more about test types, see [Tests](https://docs.thousandeyes.com/product-documentation/tests).

* Network Layer Tests: [Network Tests](https://docs.thousandeyes.com/product-documentation/tests/network-tests)
* Routing Layer Tests: [BGP Tests](https://docs.thousandeyes.com/product-documentation/tests/bgp-tests)
* DNS Layer Tests: [DNS Tests](https://docs.thousandeyes.com/product-documentation/tests/dns-tests)
* Web Layer Tests: [Web Layer Tests](https://docs.thousandeyes.com/product-documentation/tests/web-layer-tests)
* Voice Layer Tests: [Voice Tests](https://docs.thousandeyes.com/product-documentation/tests/voice-tests)

### Test Settings List

To view a list of all of your tests, 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>. If your account has at least one agent available, then the interface will show 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 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.

![Test Settings List Table Column Settings](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-dd0f48e73df28e31897755bdccfe5b5f5f7130a6%2Fcea-test-settings-list-edit-columns.png?alt=media)

#### Filtering Tests

You can filter the tests listed in three ways, by searching for text, adding a filter, and selecting options from filter menus.

![Filtering options for the test settings page](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-9c0c9598f40c5ecc23402615b1df3c96fed71047%2Fcea-test-settings-list-filters.png?alt=media)

**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.

![Test Settings List Search](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-84520ff859faa27e6f8961d9b1a1b1716f7446cc%2Fcea-test-settings-list-search.png?alt=media)

**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.

![Adding a filter to the test settings list](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-00f173d83a9043f40476b75b151d86eb8c15d240%2Fcea-test-settings-list-add-filter.png?alt=media)

**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, Tags, 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.

![Filtering test settings using the Type filter](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-6c12b194c5530e84ff8b081790fe3c4f7a0ec657%2Fcea-test-settings-list-filters-detail.png?alt=media)

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`).

![Filtering test settings using the Tags filter](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-ceccc98a870c603bbed364a7f4981b66d4c371ac%2Fcea-test-settings-list-filter-by-tags.png?alt=media)

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](#adding-tests-manually).

Some fields cannot be edited after the test has been created:

| Test Type   | Immutable setting |
| ----------- | ----------------- |
| 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 will not delete the test data, but the data will expire on a daily rolling basis. See [How Long Does ThousandEyes Retain Customer Data?](https://docs.thousandeyes.com/product-documentation/user-management/user-activity/how-long-does-thousandeyes-retain-customer-data) for more information about data retention periods. Disabled tests do not consume [units](https://docs.thousandeyes.com/product-documentation/user-management/usage-and-billing/about-our-consumption-model).

### Updating Multiple Tests

From the test settings list, select the checkbox to the left of each test you want to update. Currently only enabling or disabling tests is supported. Scroll down to the bottom of the screen and click the **Enable** button to enable the selected tests, or click the **Disable** button to disable the selected tests.

A side panel opens that lists the tests that can be updated. A count of the selected tests that cannot be updated is also reported. To continue with the update, click the blue button.

![List of Tests to be Updated](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-61c9603ed31aaa3522b2ca4dc3492a2e627d129e%2Fcea-test-settings-list-bulk-update-dialog.png?alt=media)

A confirmation screen appears indicating the update was being processed. Click **View Job** to view the status of your update.

![Successful Update of Multiple Tests](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-f49703873aeab45389b9fa20c2331e5388bc99c0%2Fcea-test-settings-list-bulk-update-ok.png?alt=media)

If the update was not processed, an error screen shows with an option to retry. Click **Retry** to retry the update.

![Unsuccessful Update of Multiple Tests](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-33f824881410fbf552736fde00ece31d45625913%2Fcea-test-settings-list-bulk-update-error.png?alt=media)

### 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.

![Showing a deleted test in the Test Settings List](https://1112912342-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4QARF6s57qxMrOHDTZ%2Fuploads%2Fgit-blob-89e1b9ecd165260b48ae1acf887de7cee2101af4%2Fcea-test-settings-list-delete.png?alt=media)

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](#adding-tests-manually).

## Related Articles

* To learn more about ThousandEyes metrics, see [ThousandEyes Metrics: What Do Your Results Mean?](https://docs.thousandeyes.com/product-documentation/thousandeyes-basics/thousandeyes-metrics-what-do-your-results-mean).
* To understand how a test results can be shared, visit [Sharing Test Data](https://docs.thousandeyes.com/product-documentation/internet-and-wan-monitoring/tests/sharing-test-data)