Node Rule-Based Room Assignment

You can 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.

How It Works

Rules automatically assign Nodes to Rooms based on their host labels. When you create a rule, it continuously evaluates all Nodes and assigns them to the appropriate Room when they match your criteria.

Rule Evaluation Order:

• Exclusion rules are evaluated first
• Inclusion rules are evaluated second

In cases where both an inclusion and exclusion rule match, the exclusion rule takes precedence.

Child Node Behavior

• Child nodes that are only indirectly connected to Cloud (through a Parent Agent) are no longer automatically added to the same Room as the Parent.
• If your workflow depended on this automatic grouping, we recommend setting up Room assignment rules.

:::tip

This allows for fine-grained automatic assignment of nodes to Rooms based on hostnames or other host labels.

:::

:::important

• You can use rules with all Rooms except the "All Nodes" Room, as it includes all Nodes by default
• You need Node management permissions to create and edit Rules
• Rules are evaluated in real-time as labels change
• Exclusion rules always override inclusion rules

:::

Create Your First Rule

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

Rule Structure

You can build rules with the following elements:

Each clause consists of:

Example Rule Structure:

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

Comparison Operators

You can use the following operators to compare label values:

Membership Status

Nodes can have multiple membership types in a Room:

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

:::note

Group membership can be either STATIC or RULE—these work independently. A node can belong to groups through STATIC assignments (added manually) or through RULE assignments (matched automatically). RULEs cannot override STATIC memberships, and removing a node's STATIC membership does not affect its RULE memberships.

:::

If you run multiple environments (such as dev, acc, and prod) in a single Kubernetes cluster, you can use custom host labels and room assignment rules to automatically route each environment's Nodes into separate Rooms.

Step 1 — Set host labels on child Nodes

Use the Helm chart's child.configs.netdata.data override to add a [host labels] section to every child Node. Create (or edit) an override.yml file:

child:
  configs:
    netdata:
      data: |
        [host labels]
          environment = ${CLUSTER_ENV}

Deploy or upgrade with the override:

helm upgrade --install -f override.yml netdata netdata/netdata

Set CLUSTER_ENV to dev, acc, or prod per cluster (or node pool) via your deployment tooling. For more Helm chart options, see the Kubernetes installation guide and the Helm chart reference.

Step 2 — Create one Room per environment

In Netdata Cloud, create three Rooms — for example Dev, Acc, and Prod.

Step 3 — Create inclusion rules

In each Room's Nodes tab, add an inclusion rule that matches the environment host label:

Rules are evaluated in real time — as soon as a child Node connects with the matching label, it is assigned to the corresponding Room.

:::note

Netdata deploys one child Agent per Kubernetes node, not per namespace or workload, and Room assignment rules apply to that child Agent as a whole. This pattern works best when each environment runs on dedicated nodes or node pools. If environments share the same nodes, host-label rules cannot route namespaces on those nodes into different Rooms.

:::