Add Tags to Instances
Follow the steps in this guide to create tags for organizing your instances.
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
agent-dynamic.conf
file. - Add tags using the Instance Manager web interface.
Add Tags with a Configuration File
You can edit the agent-dynamic.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
/var/lib/nginx-agent/agent-dynamic.conf
file and add the tags in a list under the keytags:
Note:
If you’re running Instance Manager 2.10.1 or earlier or NGINX Agent 2.25.1 or earlier, theagent-dynamic.conf
file is located in/etc/nginx-agent/
. -
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:
-
In a web browser, go to the FQDN for your NGINX Management Suite host 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.