Skip to main content

Node Rule-Based Room Assignment

Organize Nodes within Rooms automatically using configurable label-based rules. This feature simplifies infrastructure management by dynamically assigning Nodes to appropriate Rooms based on their host labels, eliminating manual intervention.

Important:

  • Rules work with all Rooms except the "All Nodes" Room, as it includes all Nodes by default.
  • Creating and editing Rules requires Node management permissions.
  • Rules are evaluated in real-time as labels change.
  • Exclusion rules always override inclusion rules.

Rule Structure

The rules consist of the following elements:

ElementDescription
ActionDetermines whether matching Nodes will be included or excluded from the Room
ClausesSet of conditions that determine which Nodes match the Rule (all must be satisfied - logical AND)

Each clause consists of:

ElementDescription
LabelThe host label to check
ValueThe comparison method
OperatorThe value to compare against

Below is a conceptual representation of a rule that includes all production database Nodes. The structure is shown in YAML format for clarity:

Action: Include
Clauses:
- Label: environment
Operator: equals
Value: production
- Label: service-type
Operator: equals
Value: database

Rule Evaluation Order

  • Inclusion rules are checked first
  • Exclusion rules are checked second If both match, exclusion wins

Creating Rules

  1. Access Settings
    • Click ⚙️ (Room settings)
    • Select "Nodes" tab
  2. Create Rule
    • Click "Add new Rule"
    • Select Action (Include/Exclude)
    • Add clause(s)
    • Save changes

Membership Status

Nodes can have multiple membership types in a Room:

StatusDescription
STATICManually added to the Room
RULEAdded by matching Rule(s)
STATIC and RULEBoth manual and Rule-based

You can view each Node's membership status in the Room's Nodes table under the "Membership" column.


Do you have any feedback for this page? If so, you can open a new issue on our netdata/learn repository.