Add Tags to Instances
Follow the steps in this guide to create tags for organizing your instances.
This documentation applies to NGINX Management Suite Instance Manager 2.0.0 and later.
Overview
Tags allow you to label and group NGINX instances in Instance Manager.
Adding a Tag
There are two ways you can add tags:
- Add tags to the
nginx-agent.conf
file. - Add tags using the Instance Manager web interface.
Add Tags with a Configuration File
You can edit the nginx-agent.conf
file to add a tag to an instance.
These tags show up during registration and can’t be removed from the web interface – if you try to remove these tags in the web interface, the NGINX Agent adds them back when restarting.
To add tags to the configuration file, take the following steps:
-
Edit the
/etc/nginx-agent/nginx-agent.conf
file and add the tags in a list under the keytags:
-
Restart the NGINX Agent service:
sudo systemctl restart nginx-agent
Add Tags using the Web Interface
To add tags using the Instance Manager web interface, take the following steps:
-
Open the NGINX Management Suite web interface and log in.
-
In the left menu, select Instances.
-
Select an instance row in the list of instances. An informational panel for the instance is displayed.
-
Select Edit.
-
In the System Tags box, select one or more tags to associate with the instance. To add a new tag, type the name for the tag, then select Add New Tag.
- You can remove a tag from an instance by clicking the
x
next to the tag’s name.
- You can remove a tag from an instance by clicking the
-
Select Save.