Work with Key-Value Tags

Create a New Tag

You can create tags centrally from the Tags workspace or inline while configuring an asset.

To create a tag from the Tags workspace:

1. Navigate to Manage > Tags.

2. Select Add tag.

3. In the Key field, enter a primary identifier (up to 128 alphanumeric characters, hyphens, or underscores).

   If you plan to use this tag in an OpenTelemetry streaming integration, avoid spaces and other non-compliant characters in the tag key. Non-compliant keys are excluded from streamed data. For details, see Tags as Attributes.

4. In the Value field, enter the specific value (optional, up to 128 characters).

5. Under Select shape, select an icon to represent the tag (such as a circle, triangle, or server icon).

6. Under Select color, select a color for the tag.

7. (Optional) Enter a Description to help other users understand the tag's purpose.

8. Under Select tag type, choose Static tag or Dynamic tag. Dynamic tags apply only to Endpoint Experience Agents and use rules to assign tags automatically; see Manage dynamic tags for Endpoint Agents.

9. Under Assign product area to tag, select the product area for the tag (for example, Network & App Synthetics tests or agents, Endpoint Experience tests, Dashboards, or Connected Devices tests).

10. Select Save and assign items to create the tag. Follow the prompts to assign items now, or finish the flow if you do not need to assign any yet.

Add New Tag side panel - Key, Value, shape, color, description, tag type, product area, and Save and assign items

Create a Tag Inline

When configuring an asset, such as a test or an agent, you can create a tag on the fly:

1. Select the Add tags field on the asset configuration page.

2. Start typing your desired tag. Use a colon (:) to separate the key and the value (for example, Europe: Amsterdam).

3. If the tag does not exist, the dropdown will prompt you to Create New Tag.

4. Select Save. The new tag is automatically applied to the asset and inherits the default icon and color.

Assign Tags to Assets

To assign an existing tag to an asset:

1. Open the configuration page for the test, agent, or dashboard.

2. Locate the tag selector field.

3. Select the field to open the dropdown menu. You can scroll through the alphabetical list or type to search.

4. Select the tags you want to apply. You can select multiple tags for a single asset.

Manage Assigned Items from a Tag

You can assign a tag to multiple assets (such as tests or agents), or remove the tag from them, directly from the Tags workspace.

1. Navigate to Manage > Tags.

2. Select the ... (options) menu next to the tag you want to modify.

3. Select Manage Assigned Items.

Tag detail panel with overflow menu open showing Manage Assigned Items

1. In the dialog that appears, select or deselect the items you want to associate with the tag.

2. Select Save.

Filter Using Tags

Tags allow for advanced filtering across the ThousandEyes platform.

• In dashboards: Use the global filter or widget-level filters to isolate data. For example, filtering by APP: Salesforce will update all applicable widgets to show only data related to that tag.

• In views: Use the tag selector to filter test results or group tests by specific keys.

• In alert rules: Use tag-based selectors with AND/OR logic to target tests and agents.

Edit or Delete Tags

1. Navigate to Manage > Tags.

2. To edit, select the Edit icon next to the tag. Note that changing a tag's key or value will update it across all assigned assets.

3. To delete, select the checkbox next to one or more tags, and select Delete. Note: Deleting a tag removes it from all associated assets. This action cannot be undone.