Groups & Tags

Organize your Hive agents into groups and apply tags to filter, manage, and operate on sets of servers together.

Groups

Groups are folders for your agents. Use them to mirror your infrastructure topology — by environment (production, staging, dev), function (web, database, worker), team ownership, or cloud region.

Creating a Group

1. Go to Hive → Agents
2. Click New Group
3. Fill in the group details

Nested Groups

Groups support nesting to any depth. For example:

Production
├── Web Servers
│   ├── us-east-1
│   └── eu-west-1
└── Databases
    ├── Primary
    └── Replicas

Moving Agents into a Group

1. Open the agent detail
2. Click Edit
3. Set the Group field
4. Save

Or drag the agent card into the target group from the Agents board view.

Group Overview

Click a group to see:

• All agents in the group and their live status
• Aggregate alert counts for the group
• Ungrouped agents count (shown separately)

Tags

Tags are free-form labels you can attach to any agent. Unlike groups, a single agent can have multiple tags.

Creating Tags

1. Go to Hive → Tags (or from the agent edit modal)
2. Click New Tag

Applying Tags to Agents

1. Open the agent detail
2. Click Edit
3. Select tags from the tags dropdown
4. Save

Multiple tags can be applied to a single agent.

Filtering by Tag

On the Agents page, use the Tags filter to show only agents with a specific tag. Useful for:

• Seeing all nginx servers at once
• Filtering to on-call tagged servers during incidents
• Bulk reviewing deprecated agents before decommission

Groups vs Tags

Ungrouped Agents

Agents not assigned to any group appear under Ungrouped at the bottom of the Agents list. As your fleet grows, regularly reviewing ungrouped agents helps keep the inventory organized.