Tagging Agent
Last updated
Last updated
Agent tagging in GuardMode allows you to organize instances of the GuardMode Agent by tagging them under a shared "campus" value. Tags are added to every alert, both in provider notifications and logs.
In DPX notifications, the tags are displayed as labels. In Syslog notifications, they are added as prefixes to the messages in the following way:
Tags can include letters, numbers, dashes, and underscores
All tags are normalized to lowercase.
Each tag can be up to 250 alphanumeric characters.
Tip. GuardMode Agent tags can be managed using REST API or the CLI.
To view Agent Tags, send a GET request to /settings/tags.
The response includes IDs for each tag. The collection is empty by default.
To view Agent Tags using the CLI:
To add a tag to GuardMode Agent, send a POST request to /settings/tags:
You need to specify the tag name in the request body in the following way:
Attention! Do not add the same tag twice.
To add a tag to GuardMode Agent using the CLI:
Delete a tag by sending a DELETE request to /settings/tags/{id}:
The tag ID can be obtained from the GET request response to the same endpoint.
To remove a tag to GuardMode Agent using the CLI: