Configure Scheduled Tests

ThousandEyes users can create HTTP server tests and agent-to-server tests that run without user interaction at regularly scheduled intervals for as long as the Endpoint Agent is online, providing data from remote employees and smaller branch offices.
This article includes instructions for creating, modifying, and deleting scheduled tests, as well as reference information for the various configurable test settings.

Prerequisites

  • ThousandEyes Endpoint Agent software version 0.96 or later. Versions prior to 0.96 cannot run scheduled tests.
  • The users must have the required permissions to create tests.
  • The required Endpoint Agent labels have been created.

Create a Scheduled Test

To create a scheduled test:
  1. 2.
    Click the Add New Test button.
  2. 3.
    Define the type of test. See Guide to ThousandEyes Test Types for information on the two available test types.
  3. 4.
    Configure the basic settings for the test. See Scheduled Test Settings Reference for summaries of each option.
  4. 5.
    Optional: Configure the advanced settings. See Scheduled Test Settings Reference for summaries of each option.
  5. 6.
    Optional: Click the Show Details link and open the Add Labels drop-down list to add any test labels.
  6. 7.
    Click Run Once to run an instant test, click Add New Test to save the test, or click Cancel to discard the changes.
By default, the tests are assigned to the agent in the manner explained here.

Manage Existing Scheduled Tests

The Endpoint Agents > Monitoring Settings > Scheduled Tests tab displays a table of all existing Endpoint Agent tests:
The table shows the test name, test labels, test type, target URL/IP address, when the test was last modified, the number of agents assigned to the test in the last 24 hours, and whether the test is currently enabled or not.

Enable / Disable Scheduled 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 a Scheduled Test

By default, when scheduled tests are assigned to execution slots, they are prioritized as follow:
  1. 1.
    Tests which target specific machines
  2. 2.
    Tests which target specific labels
  3. 3.
    All agents
However, you can choose whether a scheduled test can override the default prioritisation plan.
To prioritise a scheduled test:
  1. 1.
    Navigate to the desired test displayed in the Endpoint Agents > Monitoring Settings > Scheduled 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 > Monitoring Settings > Scheduled 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 Scheduled Test Settings Reference for summaries of each option.
  4. 4.
    Click Run Once to run an instant test, 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 label:
  1. 1.
    From the Endpoint Agents > Monitoring Settings > Scheduled 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 Scheduled Test Settings Reference for summaries of each option.
  5. 5.
    Click Run Once to run an instant test, 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 > Monitoring Settings > Scheduled 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.