Agent Tags

Organization-Scoped Labels

Agent tags are color-coded labels scoped to your organization. Use them to categorize agents by function, location, team, or any custom grouping.

Common patterns: by client (acme-corp, acme-corp-prod) for MSPs managing multiple environments, or by site, OS, or rollout wave (hq-seattle, pilot-group, windows-11) for internal IT teams. A tag set is shared across every agent in the organization — there is no per-device tag namespace.

Creating Tags

  1. Click the tag area on any agent row in the Agents page
  2. In the Tag Modal, click Create New Tag
  3. Enter a Name, optional Description, and pick a Color
  4. The tag is created at the organization level and available for all agents

Assigning & Removing Tags

  • The Tag Modal shows Current Tags and Available Tags sections
  • Click a tag in Available to assign it; click × on a Current tag to remove it
  • Each tag shows its usage count across all agents
  • Up to 3 tags shown inline on agent rows with “+N” overflow

Deleting a Tag from Your Organization

The × on a Current tag only unassigns it from that one device. To delete a tag entirely, open the Manage Tags modal from any device: every organization tag is listed (assigned tags are marked with a ✓), and each carries a small × delete control. Clicking it asks you to confirm, then permanently removes the tag from your organization and from every device that had it assigned. This cannot be undone.

Using Tags in Alert Rules

Use the agent_tags metric in alert rule conditions to target specific agent groups (e.g., “agent_tags contains production”).

Alert rules do not store a reference to the tag itself — each evaluation re-reads the agent’s current tags from the database and compares against that live list. If you delete a tag, no agent’s tag list will contain it anymore, so any rule condition referencing it simply stops matching. The rule itself is not deleted, disabled, or flagged as broken.