Working with dashboard tags

The Labels feature has been upgraded to Tags. All your existing labels have been automatically migrated to the new tagging system with no action required on your part. Existing labels were converted to a tag key with an empty value (for example, a label named subnet-10 is now a tag with the key subnet-10 and no value). You can now manage all tags centrally by navigating to Manage > Tags.

Tags provide an easy-to-use folder structure that allows you to organize your data visualization efforts in the ThousandEyes platform. Tags make it easier to group applications, multiple locations, or thousands of endpoints.

You can create a tag for a specific context and assign the corresponding dashboards. This way, when you filter the dashboard selection and select a tag, only the associated dashboards are displayed. You can also Group By tags, meaning the hierarchy of the dashboard selector will have a tag as its top-level association and every dashboard associated with that tag will fall under that hierarchy.

By default, you can group and sort dashboards by tags. To create, edit, or delete tags, you need the appropriate permissions. In the API, tag management is controlled by the SETTINGS_LABELS_UPDATE permission identifier (it may appear as SETTINGS_TAGS_UPDATE if the identifier has been renamed in your environment). For role-based access control (RBAC), the related permission names in ThousandEyes are Edit tags and View tags, which replace Edit labels and View labels. For more information, see Role-Based Access Control, explained and the roles and permissions table.

Manage Dashboard Tags

You can manage tags in the following two locations:

• Dashboard Selector: This dropdown menu provides a list of existing dashboards, along with a Search field, filter options to search the list, tags, and other grouping options.

The Manage link beside Custom Tags is used to manage dashboard tags. You can also manage all tags at Manage > Tags.

• Edit Dashboard: This option is located in the Options button or ellipsis icon, and provides you with the ability to edit the dashboard details.

The Manage Tags link beside the Tags dropdown is used to manage dashboard tags.

To manage dashboard tags:

1. Click the Manage link or Manage Tags link located in the dashboard selector and edit dashboard sections respectively.

2. Both links open the side panel for managing dashboard tags (or navigate to Manage > Tags for the full Tags workspace).

1. The panel displays a table of all existing dashboard tags along with a Search field and filter options to search the list.

Create a New Tag

To create a new tag:

1. Navigate to the dashboard tags management panel or Manage > Tags.

2. Click the New Tag or Add tag button.

1. Enter the Key and Value (or Name), select the Color, and assign the associated dashboards from the Dashboards dropdown.

2. Click Add or Save to confirm the creation of the tag.

Add Dashboard to a Tag

To add a dashboard to a tag:

1. Navigate to the dashboard tags management panel or Manage > Tags.

2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.

3. Click on the ellipsis icon and select Edit option.

1. You can select the desired dashboards to add them to this tag.

2. Click Save to confirm the changes.

Alternatively, you can also add the dashboard to a tag using the Edit Dashboard option in the Options button or ellipsis icon.

Select the tags from the Tags dropdown that you intend this dashboard to be associated with.

Edit an Existing Tag

To edit an existing tag:

1. Navigate to the dashboard tags management panel or Manage > Tags.

2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.

3. Click on the ellipsis icon and select Edit option.

4. You can edit the key, value, color, and dashboards assigned to the tag.

5. Click Save to confirm the changes.

Delete a Tag

To delete an existing tag:

1. Navigate to the dashboard tags management panel or Manage > Tags.

2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.

3. Click on the ellipsis icon and select Delete option.

4. Click Delete to confirm the deletion.

Duplicate an Existing Tag

To duplicate an existing tag:

1. Navigate to the dashboard tags management panel or Manage > Tags.

2. Select the desired tag from the table displaying all the tags. You can also use the search bar to find the tag.

3. Click on the ellipsis icon and select Duplicate option.

4. Enter the Name or Key/Value for the duplicate tag. The rest of the fields are populated based on the original tag. However, you can edit them accordingly.

5. Click Save to confirm the creation of the duplicate tag.