Configure Endpoint Agent Labels

In contrast to tests run on Cloud and Enterprise Agents, where tests are assigned to agents statically, Endpoint Agent scheduled tests are assigned to agents dynamically using labels. This is because Endpoint Agents may be frequently offline, as they are deployed on local workstations, and the network address, location, and other characteristics of the host may change. An Endpoint Agent label has a series of filters applied to it, and whenever an Endpoint Agent checks in with ThousandEyes, the criteria of each label is compared to the agent's current information. If the agent matches the label, any test assigned that label (up to a maximum of 10 tests) is assigned to the agent.

If an Endpoint Agent does not check in for an hour, the agent is deemed offline, and the label assignment is removed. When the Endpoint Agent next successfully checks in, the label is re-assigned based on the configured filters.

Endpoint Agent labels can be configured from the Endpoint Agents > Agent Settings > Agent Labels tab. This article outlines the steps to create, manage, and delete Endpoint Agent labels.

Create an Endpoint Agent Label

To create a new label:

  1. From the Endpoint Agents > Agent Settings > Agent Labels tab, click Add New Label to open the side panel.

  2. Define the label's name.

  3. Choose a color for the label.

  4. Use the Filter drop-down lists to configure a filter for the label. Additional filters can be added, and existing ones can be changed/removed, by using the Plus and Minus icons beside each filter row.

    Note: The list of available/matching agents that fit the filters is dynamically updated as filters are added/changed/removed, both in list and graph form.

  5. Once the label is configured, click Save Changes to create the label.

Manage Existing Endpoint Agent Labels

The Endpoint Agents > Agent Settings > Agent Labels tab displays a table of all existing Endpoint Agent labels:

The table shows the label name, label filters, and the number of agents that currently match the label.

Configure an Existing Label

To configure an existing label:

  1. From the Endpoint Agents > Agent Settings > Agent Labels tab, identify the label that should be configured, either by scrolling down the list, or by searching for it by name.

  2. Click the relevant row in the table to open the side panel.

  3. Configure the Endpoint Agent label as desired. The label name, flag color, and filters can be configured:

  4. Click Save Change to save the label, or Cancel to revert the changes.

Duplicate an Existing Label

To create a duplicate of an existing label:

  1. From the Endpoint Agents > Agent Settings > Agent Labels tab, identify the label that should be duplicated, either by scrolling down the list, or by searching for it by name.

  2. Click the three dots icon at the end of the label row:

  3. Click Duplicate to create an identical label with "Copy" added to the end of the name.

Delete an Existing Label

To delete an existing Endpoint Agent label:

  1. From the Endpoint Agents > Agent Settings > Agent Labels tab, identify the label that should be deleted, either by scrolling down the list, or by searching for it by name.

  2. Click the three dots icon at the end of the label row.

  3. Click Delete.

  4. Click Delete to confirm the change, or cancel to revert.

A warning will be shown before deleting the label if any tests are currently assigned the label.