Tag management

To help manage resources, the KUMA web interface lets you add tags to resources. You can use tags to search for a component, as well as manage tags, link or unlink tags.

You cannot add tags to resources that are created from the interface of other resources. Tags can be added only from the resource's own card. You also cannot add tags to a resource that is not editable.

Tag management

The list of tags is displayed in the Settings → Tags section and is displayed as a table with the following columns: Name, Tenant, Used in resources.

In the Tags table, you can:

• Sort tags by Name, Used in resources fields.
• Filter by values of the Tenant field.
• Find a tag by the Name field.
• Go to the list of resources that have the selected tag.

Adding a tag

To add a tag:

1. Go to the Resources section and select a resource.
2. In the panel above the table, click Add.
3. In the Tags field of the selected resource, add a new tag, or select a tag from the list.
4. Click Create.

The new tag is added.

You can also add tags from existing ones.

When adding a tag, keep in mind the following special considerations:

• You can add multiple tags.
• A tag can contain characters of various alphabets (for example, Cyrillic, Latin, or Greek characters), numerals, underscores, and spaces.
• A tag may not contain any special characters other than the underscore and the space.
• You can enter the tag in uppercase or lowercase, but after saving, the tag is always displayed in lowercase.
• The tag inherits the tenant of the resource in which it is used.
• A tag is part of a resource and exists as long as the resource exists in which the tag was created or is used.
• Tags are unique within a tenant.
• Tags are imported or exported together with the resource as part of the resource.

Searching by tags

In the Resources section, you can search for resources:

• By tags
• By resource name

The search is performed across all resource types and services.

The search results display a list of resources and services.

To find resources by tags:

1. Go to the Resources section and select a resource.
2. In the table of the resource, select the Tags column.
3. In the Search field that is displayed, enter or select a tag name.

   Searching by tag in the resource itself and in the list of resources returns full as well as partial matches of the entered text with the name of the tag.

Displays a list of resources if the specified tag is used in those resources.

In the list of resources, you can:

• Sort the list by name and type of resource or service.
• Filter resources or services by resource or service type, or by tag.
• Link or unlink tags.

Displaying tags while adding dependent resources

While adding a dependent resource, the tags of this resource are displayed in a drop-down list under Filter settings.

Resource tags that to not fit a single line are hidden. A special indicator lets you see that hidden tags exist.

The drop-down list can be filtered by resource name and by resource tags.

Linking and unlinking tags

To link tags to a resource or unlink tags from a resource:

1. Go to the Resources section.
2. Select the List tab.
3. In the Name column, select the check boxes next to the relevant resources.
4. In the panel above the list, select the Tags tab.
5. Click Link or Unlink, select the tags that you need or create a new tag.

The selected tags are linked to or unlinked from the resources.

You can also link or unlink tags in the card of the resource.

Page top