docs/alerts-and-notifications/notifications/centralized-cloud-notifications/manage-alert-notification-silencing-rules.md
From the Cloud interface, you can manage your space's Alert notification silencing rules settings as well as allow users to define their personal ones.
flowchart TD
Space("Space Level") --> Room("Room Level")
Room --> Node("Node Level")
Node --> Alert("Alert Level")
Space --> SpaceRules("Space Silencing Rules
Affects All Users")
Room --> RoomRules("Room-Specific Rules
Target Specific Teams")
Node --> NodeRules("Node-Specific Rules
Individual Servers")
Alert --> AlertRules("Alert-Specific Rules
Granular Control")
%% Style definitions
classDef alert fill:#ffeb3b,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef neutral fill:#f9f9f9,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef complete fill:#4caf50,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef database fill:#2196F3,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
%% Apply styles
class Space alert
class Room,Node complete
class Alert database
class SpaceRules,RoomRules,NodeRules,AlertRules neutral
flowchart TD
Start("Need to Silence Alerts?") --> Scope("Who Should Be Affected?")
Scope -->|"All Users"| SpaceRule("Create Space Rule
Admin/Manager Required")
Scope -->|"Just Me"| PersonalRule("Create Personal Rule
Any Role Except Billing")
SpaceRule --> Target("What to Target?")
PersonalRule --> Target
Target -->|"All Infrastructure"| AllNodes("All Rooms + All Nodes")
Target -->|"Specific Team"| SpecificRoom("Target Specific Room")
Target -->|"Individual Server"| SpecificNode("Target Specific Node")
Target -->|"Alert Type"| SpecificAlert("Target Alert Context/Name")
%% Style definitions
classDef alert fill:#ffeb3b,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef neutral fill:#f9f9f9,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef complete fill:#4caf50,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
classDef database fill:#2196F3,stroke:#000000,stroke-width:3px,color:#000000,font-size:18px
%% Apply styles
class Start alert
class Scope,Target database
class SpaceRule complete
class PersonalRule complete
class AllNodes,SpecificRoom,SpecificNode,SpecificAlert neutral
To manage space-level silencing rules, you need:
To manage your personal silencing rules, you need:
:::note
You can only add rules if your space is on a paid plan.
:::
You can also create silencing rules directly from the Alerts tab or Nodes tab:
You will see configured Alert notification silencing rules for the space (if you aren't an observer) and yourself.
| Action | Description |
|---|---|
| Add New Rule | Create silencing rules for "All users" (administrators/managers only) or "Myself" |
| Edit Existing Rule | Modify name, scope, criteria, and timing |
| Enable/Disable Rule | Use toggle to activate or deactivate rules |
| Delete Rule | Remove silencing rules using the trash icon |
Rooms: Which Rooms will this apply to?
Nodes: What specific Nodes?
Host Labels: Does it apply to host labels key-value pairs?
</details> <details> <summary><strong>Alert Criteria</strong></summary>Alert Name: Which alert name is being targeted?
Alert Context: What alert context?
Alert Role: Will it apply to a specific alert role?
</details> <details> <summary><strong>Timing Options</strong></summary>Immediate: From now until turned off or until specific duration (start and end date automatically set).
Scheduled: Specify start and end time when the rule becomes active and inactive (time set according to your browser local timezone).
</details>Use Case: Complete infrastructure maintenance affecting all users
Configuration Steps:
Validation Checklist:
Use Case: Database team doesn't want notifications for their managed servers.
Configuration Steps:
Validation Checklist:
Use Case: Specific server undergoing maintenance
Configuration Steps:
Validation Checklist:
Use Case: Planned stress testing that will trigger CPU alerts
Configuration Steps:
:::tip
Validation Checklist:
:::
</details>:::tip
Before activating any silencing rule, verify:
| Category | Validation Item | Description |
|---|---|---|
| Basic Configuration | Rule name is descriptive | Include purpose/date for easy reference |
| Correct scope selected | Choose "All users" vs "Myself" appropriately | |
| Proper permissions for scope | Admin/manager required for "All users" | |
| Target Validation | Room selection matches scope | Ensure intended rooms are targeted |
| Node specification is accurate | Use * for all, specific names for targeted nodes | |
| Host labels correctly formatted | Use key:value pairs format | |
| Alert Criteria | Alert name/context matches | Verify targeting intended alerts |
| Alert role properly specified | Use role-based alerting correctly | |
| Wildcard (*) used appropriately | Apply broad targeting where needed | |
| Timing Configuration | Immediate vs Scheduled selection | Choose appropriate timing method |
| Start/end times set correctly | Consider browser timezone | |
| Duration appropriate | Match planned activity timeframe | |
| Impact Assessment | Stakeholders notified | Inform team of silencing rule activation |
| Alternative monitoring in place | Ensure backup monitoring if needed | |
| Rule deactivation planned | Schedule rule removal after maintenance |
:::
| Scenario | Configuration | Use Case |
|---|---|---|
| Infrastructure Maintenance | All Rooms, All Nodes (*) | Complete infrastructure-wide maintenance window |
| Team-Specific Silencing | Specific Room (e.g., PostgreSQL Servers) | Team doesn't want notifications for their managed nodes |
| Single Node Maintenance | Specific node (e.g., child1) | Node undergoing maintenance |
| Environment-Based Silencing | Host label: environment:production | Maintenance on production environment nodes |
| Third-Party Service Issues | Specific alert name | External service maintenance affecting monitoring |
| Load Testing | Alert context: system.cpu | Planned stress testing on CPU resources |
| Role-Based Control | Alert role: webmaster | Silence all alerts for specific role |
| Granular Alert Control | Specific alert + specific node | Targeted silencing for known issues |
| Storage Maintenance | Alert: disk_space_usage, Instance: specific mount | Maintenance on specific storage volumes |
| Rule Name | Rooms | Nodes | Host Label | Alert Name | Alert Context | Alert Instance | Alert Role | Description |
|---|---|---|---|---|---|---|---|---|
| Space silencing | All Rooms | * | * | * | * | * | * | Silences entire space, all nodes, all users. Infrastructure-wide maintenance window |
| DB Servers Rooms | PostgreSQL Servers | * | * | * | * | * | * | Silences nodes in PostgreSQL Servers Room only, not All Nodes Room |
| Node child1 | All Rooms | child1 | * | * | * | * | * | Silences all Alert state transitions for node child1 in all Rooms |
| Production nodes | All Rooms | * | environment:production | * | * | * | * | Silences Alert state transitions for nodes with environment:production label |
| Third party maintenance | All Rooms | * | * | httpcheck_posthog_netdata_cloud.request_status | * | * | * | Silences specific Alert during third-party partner maintenance |
| Intended stress usage on CPU | All Rooms | * | * | * | system.cpu | * | * | Silences specific Alerts across all nodes and their CPU cores |
| Silence role webmaster | All Rooms | * | * | * | * | * | webmaster | Silences all Alerts configured with role webmaster |
| Silence Alert on node | All Rooms | child1 | * | httpcheck_posthog_netdata_cloud.request_status | * | * | * | Silences specific Alert on child1 node |
| Disk Space Alerts on mount point | All Rooms | * | * | disk_space_usage | disk.space | disk_space_opt_baddisk | * | Silences specific Alert instance on all nodes /opt/baddisk |