Get Started with Tags

ThousandEyes uses a flexible, key-value tagging infrastructure to help you organize, filter, and manage your platform assets. Tags replace the legacy labels system, providing dynamic, contextual metadata that spans across tests, agents, dashboards, and alerts.

By using tags, you can:

• Improve resource organization: Group assets logically using key-value pairs (for example, Environment: Production or Location: EMEA).

• Streamline integrations: Standardize metadata to easily correlate ThousandEyes data with third-party IT service management (ITSM) and application performance monitoring (APM) tools like ServiceNow and AppDynamics.

• Enhance analytics: Use tags to filter dashboard widgets, group data, and create targeted alert rules.

The Tags Workspace

To access the centralized tagging interface, navigate to Manage > Tags. From this screen, you can view, create, edit, duplicate, delete, and manage assigned items for tags across all product areas (such as Cloud & Enterprise Agents, Endpoint Agents, and Internet Insights).

The Tags list displays:

Manage > Tags workspace - Tags table with columns for Icon, Tag Key, Tag Value, Tag Type, Product Area, Description, and Date Modified

• Icon: The visual shape and color assigned to the tag.

• Tag Key: The primary identifier for the tag (for example, APP or DataCenter).

• Tag Value: The specific value assigned to the key (for example, Webex or AWS).

• Tag Type: Static for tags you assign manually, or Dynamic for rule-based tags on Endpoint Experience Agents (the list may show a short summary of the rule).

• Product Area: The area of ThousandEyes where the tag applies (for example, Network & App Synthetics tests, Endpoint Experience Agents, or Dashboards).

• Description: Optional context about how the tag should be used.

• Date Modified: When the tag was last changed (you can sort by this column).

Built-In versus Custom Tags

ThousandEyes provides several built-in tags out of the box (such as Cloud, Enterprise, IPv4 Compatible, and Mobile). These cannot be deleted. All previously built-in labels have been converted to built-in tags. You can also create custom tags tailored to your organization's specific routing, application, or billing needs.

For step-by-step instructions on creating and assigning tags, see Work with Key-Value Tags.

Known Limitations and API Behavior

Fetching Tags via the API

The test details API does not return tag assignments. To retrieve tags for a specific test or agent, use the GET /v7/tags endpoint with the expand=assignments parameter. Filter the results on the client side by assignment.type (for example, test or agent) and the matching ID.

Dynamic Tags API Endpoint

The UI refers to Endpoint Agent rule-based tags as Dynamic Tags, but the API endpoint remains GET /v7/endpoint-labels for backward compatibility. You can manage Dynamic Tags using either the V7 tags API or the V7 endpoint labels API; both endpoints are synchronized.

PLG User-Defined Templates

Existing user-created test templates may still show label in the JSON editor. This display behavior does not affect functionality: templates continue to work, tests deployed from those templates apply tags correctly, and tags appear in the Tags UI. New user-defined templates and all certified templates fully support tags. A full migration of legacy template JSON editor behavior is planned before May 2026.