Configure Automated Session Tests
This article includes instructions for creating, modifying, and deleting automated session tests, as well as reference information for the various configurable test settings.

Prerequisites

  • ThousandEyes Endpoint Agent software version 1.100 or later.
  • The users must have the required permissions to create tests.
  • The required Endpoint Agent labels have been created.

Create an Automated Session Test

To create an automated session test:
  1. 2.
    Click the Add New Test button.
  2. 3.
    Configure the basic settings for the test. See Automated Session Test Settings Reference for summaries of each option.
  3. 4.
    Optional: Configure the advanced settings. See Automated Session Test Settings Reference for summaries of each option.
  4. 5.
    Click Add New Test to save the test, or click Cancel to discard the changes.

Manage Existing Automated Session Tests

The Endpoint Agents > Test Settings > Automated Session Tests tab displays a table of all existing automated session tests:
The table shows the test name, the corresponding application, the number of agents assigned to the test in the last 24 hours, and whether the test is currently enabled or not.

Enable / Disable Automated Session Tests

To enable or disable an existing test:
  1. 2.
    Click the Enabled toggle switch to set the test to either enabled (blue) or disabled (dark gray).
If the toggle is grayed out, the test has no labels assigned it that match any available agents, and cannot be enabled. Update the agents to run the test in order to enable it.

Prioritise an Automated Session Test

By default, when automated session tests are assigned to execution slots, they are prioritized as follow:
  1. 1.
    Tests which target specific agents
  2. 2.
    Tests which target specific labels
  3. 3.
    All agents
There is an additional constraint that an agent can only run a test for a given application once. If there are multiple automated session tests for the same application, the relevant test is picked according to the priority system mentioned above. If there are two application tests at the same priority level, then one of them gets picked at random. However, this choice will be consistent for a given agent (no flapping behaviour). For example consider the following scenario:
TestID
Application
Target
1
Webex
all agents
2
Webex
all agents
3
Zoom
[Agent1, Agent2]
4
Zoom
all agents
Here, agent1 may run the tests 3 and 1, and agent 2 may run tests 3 and 2.
However, you can choose whether an automated session test can override the default prioritisation plan.
To prioritise an automated session test:
  1. 1.
    Navigate to the desired test displayed in the Endpoint Agents > Test Settings > Automated Session Tests tab.
  2. 2.
    Click the Prioritised toggle switch to prioritise (blue) the test.
You can set the test to default priority by toggling off (grey) the Priortised toggle.

Configure an Existing Test

To configure an existing test:
  1. 1.
    From the Endpoint Agents > Test Settings > Automated Session Tests tab, identify the test that should be configured, either by scrolling down the list, searching for the test with the search function, or using the available filters to focus the list of tests shown.
  2. 2.
    Click the relevant row in the table to open the side panel.
  3. 3.
    Configure the Endpoint Agent test as desired. See Automated Session Test Settings Reference for summaries of each option.
  4. 4.
    Click Save Test to save the changes, or click Cancel to discard the changes.

Duplicate an Existing Test

To create a duplicate of an existing test:
  1. 1.
    From the Endpoint Agents > Test Settings > Automated Session Tests tab, identify the test that should be configured, either by scrolling down the list, searching for the test with the search function, or using the available filters to focus the list of tests shown.
  2. 2.
    Click the three dots icon at the end of the test row.
  3. 3.
    Click Duplicate. The test configuration side panel will open with the duplicated test settings already configured.
  4. 4.
    Make any changes to the duplicate test as necessary. See Automated Session Test Settings Reference for summaries of each option.
  5. 5.
    Click Add New Test to save the test, or click Cancel to discard the changes.

Delete an Existing Test

To delete an existing Endpoint Agent test:
  1. 1.
    From the Endpoint Agents > Test Settings > Automated Session Tests tab, identify the test that should be configured, either by scrolling down the list, searching for the test with the search function, or using the available filters to focus the list of tests shown.
  2. 2.
    Click the three dots icon at the end of the test row.
  3. 3.
    Click Delete.
  4. 4.
    Click Delete to confirm the change, or cancel to revert.
Copy link
Outline
Prerequisites
Create an Automated Session Test
Manage Existing Automated Session Tests
Enable / Disable Automated Session Tests
Prioritise an Automated Session Test
Configure an Existing Test
Duplicate an Existing Test
Delete an Existing Test