2020-12-17 08:50:31 +01:00
|
|
|
[role="xpack"]
|
|
|
|
[[managing-tags]]
|
|
|
|
== Tags
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
Tags enable you to categorize your saved objects.
|
|
|
|
You can then filter for related objects based on shared tags.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
|
|
|
[role="screenshot"]
|
2021-07-20 23:32:26 +02:00
|
|
|
image::images/tags/tag-management-section.png[Tags management]
|
2020-12-17 08:50:31 +01:00
|
|
|
|
|
|
|
[float]
|
|
|
|
=== Required permissions
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
To create tags, you must meet the minimum requirements.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
* Access to *Tags* requires the `Tag Management` Kibana privilege. To add the privilege, open the main menu,
|
|
|
|
and then click *Stack Management > Roles*.
|
2020-12-17 08:50:31 +01:00
|
|
|
* The `read` privilege allows you to assign tags to the saved objects for which you have write permission.
|
|
|
|
* The `write` privilege enables you to create, edit, and delete tags.
|
|
|
|
|
|
|
|
NOTE: Having the `Tag Management` {kib} privilege is not required to
|
2021-07-20 23:32:26 +02:00
|
|
|
view tags assigned on objects you have `read` access to, or to filter objects by tags
|
|
|
|
from the global search.
|
|
|
|
|
2020-12-17 08:50:31 +01:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[settings-create-tag]]
|
|
|
|
=== Create a tag
|
|
|
|
|
|
|
|
Create a tag to assign to your saved objects.
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
. Open the main menu, and then click *Stack Management > Tags*.
|
2020-12-17 08:50:31 +01:00
|
|
|
. Click *Create tag*.
|
2021-07-20 23:32:26 +02:00
|
|
|
|
2020-12-17 08:50:31 +01:00
|
|
|
. Enter a name and select a color for the new tag.
|
|
|
|
+
|
2021-01-25 15:29:10 +01:00
|
|
|
The name cannot be longer than 50 characters.
|
2020-12-17 08:50:31 +01:00
|
|
|
. Click *Create tag*.
|
|
|
|
|
|
|
|
[float]
|
|
|
|
[[settings-assign-tag]]
|
2021-07-20 23:32:26 +02:00
|
|
|
=== Assign a tag to an object
|
2020-12-17 08:50:31 +01:00
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
To assign and remove tags from saved objects, you must have `write` permission
|
2020-12-17 08:50:31 +01:00
|
|
|
on the objects to which you assign the tags.
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
. In the *Tags* view, find the tag you want to assign.
|
|
|
|
. Click the action menu (...) in the tag row,
|
|
|
|
and then select the *Manage assignments* action.
|
|
|
|
|
|
|
|
. Select the objects to which you want to assign or remove tags.
|
2020-12-17 08:50:31 +01:00
|
|
|
+
|
|
|
|
[role="screenshot"]
|
|
|
|
image::images/tags/manage-assignments-flyout.png[Assign flyout]
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
. Click *Save tag assignments*.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
TIP: To assign, delete, or clear multiple tags at once,
|
|
|
|
select their checkboxes in the *Tags* view, and then select
|
|
|
|
the desired action from the *selected tags* menu.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
|
|
|
[float]
|
|
|
|
[[settings-delete-tag]]
|
|
|
|
=== Delete a tag
|
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
When you delete a tag, you remove it from all saved objects that use it.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
2021-07-20 23:32:26 +02:00
|
|
|
. Click the action menu (...) in the tag row, and then select the *Delete* action.
|
2020-12-17 08:50:31 +01:00
|
|
|
|
|
|
|
. Click *Delete tag*.
|