Skip to main content

Manage Alert Notification Silencing Rules

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.

Rule Hierarchy

Decision Flowchart

Prerequisites

For Space Alert Notification Silencing Rules

To manage space-level silencing rules, you need:

  • A Netdata Cloud account
  • Access to Space as administrator or manager (troubleshooters can only view space rules)
For Personal Alert Notification Silencing Rules

To manage your personal silencing rules, you need:

  • A Netdata Cloud account
  • Access to Space with any role except billing
note

You can only add rules if your space is on a paid plan.

Quick Access from Dashboard

You can also create silencing rules directly from the Alerts tab or Nodes tab:

  • From Alerts tab: Use the "Actions" column to create new silencing rules for specific alerts
  • From Nodes tab: Add alert silencing rules directly from any node row

Steps to Configure Silencing Rules

  1. Click the Space settings cog (located above your profile icon)
  2. Click the Alert & Notification tab on the left-hand side
  3. Click the Notification Silencing Rules tab

You will see configured Alert notification silencing rules for the space (if you aren't an observer) and yourself.

Rule Configuration

Available Actions

ActionDescription
Add New RuleCreate silencing rules for "All users" (administrators/managers only) or "Myself"
Edit Existing RuleModify name, scope, criteria, and timing
Enable/Disable RuleUse toggle to activate or deactivate rules
Delete RuleRemove silencing rules using the trash icon

Configuration Criteria

Node Criteria

Rooms: Which Rooms will this apply to?

Nodes: What specific Nodes?

Host Labels: Does it apply to host labels key-value pairs?

Alert Criteria

Alert Name: Which alert name is being targeted?

Alert Context: What alert context?

Alert Role: Will it apply to a specific alert role?

Timing Options

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).

Step-by-Step Wizards for Common Use Cases

Maintenance Window for All Infrastructure

Use Case: Complete infrastructure maintenance affecting all users

Configuration Steps:

  1. Choose "All users" (requires admin/manager role)
  2. Set name: "Infrastructure Maintenance [Date]"
  3. Node Criteria:
    • Rooms: All Rooms
    • Nodes: *
    • Host Labels: *
  4. Alert Criteria:
    • Alert Name: *
    • Alert Context: *
    • Alert Role: *
  5. Timing: Scheduled with maintenance window start/end times

Validation Checklist:

  • Admin/Manager permissions confirmed.
  • All rooms and nodes are targeted (*).
  • Maintenance window times are set correctly.
  • Rule name includes a date for easy reference.
Team-Specific Alert Silencing

Use Case: Database team doesn't want notifications for their managed servers.

Configuration Steps:

  1. Choose "All users" (for team-wide effect)
  2. Set name: "DB Team - PostgreSQL Servers"
  3. Node Criteria:
    • Rooms: PostgreSQL Servers
    • Nodes: *
    • Host Labels: *
  4. Alert Criteria:
    • Alert Name: *
    • Alert Context: *
    • Alert Role: *
  5. Timing: Immediate (ongoing)

Validation Checklist:

  • Correct room selected (not "All Rooms")
  • Team members have access to the specified room
  • Rule name clearly identifies team and scope
Single Node Maintenance

Use Case: Specific server undergoing maintenance

Configuration Steps:

  1. Choose "All users" or "Myself" based on impact
  2. Set name: "Node Maintenance - [NodeName]"
  3. Node Criteria:
    • Rooms: All Rooms
    • Nodes: [specific node name]
    • Host Labels: *
  4. Alert Criteria:
    • Alert Name: *
    • Alert Context: *
    • Alert Role: *
  5. Timing: Scheduled with the maintenance window

Validation Checklist:

  • Exact node name specified correctly
  • Maintenance window times confirmed
  • Other team members are notified if using "All users"
Load Testing Alert Suppression

Use Case: Planned stress testing that will trigger CPU alerts

Configuration Steps:

  1. Choose the appropriate scope ("All users" or "Myself")
  2. Set the name: "Load Testing - CPU Alerts"
  3. Node Criteria:
    • Rooms: [testing environment rooms]
    • Nodes: * (or specific test nodes)
    • Host Labels: environment:testing (if applicable)
  4. Alert Criteria:
    • Alert Name: *
    • Alert Context: system.cpu
    • Alert Role: *
  5. Timing: Scheduled for the testing period
tip

Validation Checklist:

  • Correct alert context specified (system.cpu)
  • Testing environment properly targeted
  • Testing timeframe accurately set
  • Production systems excluded

Rule Validation Checklist

tip

Before activating any silencing rule, verify:

CategoryValidation ItemDescription
Basic ConfigurationRule name is descriptiveInclude purpose/date for easy reference
Correct scope selectedChoose "All users" vs "Myself" appropriately
Proper permissions for scopeAdmin/manager required for "All users"
Target ValidationRoom selection matches scopeEnsure intended rooms are targeted
Node specification is accurateUse * for all, specific names for targeted nodes
Host labels correctly formattedUse key:value pairs format
Alert CriteriaAlert name/context matchesVerify targeting intended alerts
Alert role properly specifiedUse role-based alerting correctly
Wildcard (*) used appropriatelyApply broad targeting where needed
Timing ConfigurationImmediate vs Scheduled selectionChoose appropriate timing method
Start/end times set correctlyConsider browser timezone
Duration appropriateMatch planned activity timeframe
Impact AssessmentStakeholders notifiedInform team of silencing rule activation
Alternative monitoring in placeEnsure backup monitoring if needed
Rule deactivation plannedSchedule rule removal after maintenance

Common Silencing Scenarios

ScenarioConfigurationUse Case
Infrastructure MaintenanceAll Rooms, All Nodes (*)Complete infrastructure-wide maintenance window
Team-Specific SilencingSpecific Room (e.g., PostgreSQL Servers)Team doesn't want notifications for their managed nodes
Single Node MaintenanceSpecific node (e.g., child1)Node undergoing maintenance
Environment-Based SilencingHost label: environment:productionMaintenance on production environment nodes
Third-Party Service IssuesSpecific alert nameExternal service maintenance affecting monitoring
Load TestingAlert context: system.cpuPlanned stress testing on CPU resources
Role-Based ControlAlert role: webmasterSilence all alerts for specific role
Granular Alert ControlSpecific alert + specific nodeTargeted silencing for known issues
Storage MaintenanceAlert: disk_space_usage, Instance: specific mountMaintenance on specific storage volumes

Detailed Examples Reference

Rule NameRoomsNodesHost LabelAlert NameAlert ContextAlert InstanceAlert RoleDescription
Space silencingAll Rooms******Silences entire space, all nodes, all users. Infrastructure-wide maintenance window
DB Servers RoomsPostgreSQL Servers******Silences nodes in PostgreSQL Servers Room only, not All Nodes Room
Node child1All Roomschild1*****Silences all Alert state transitions for node child1 in all Rooms
Production nodesAll Rooms*environment:production****Silences Alert state transitions for nodes with environment:production label
Third party maintenanceAll Rooms**httpcheck_posthog_netdata_cloud.request_status***Silences specific Alert during third-party partner maintenance
Intended stress usage on CPUAll Rooms***system.cpu**Silences specific Alerts across all nodes and their CPU cores
Silence role webmasterAll Rooms*****webmasterSilences all Alerts configured with role webmaster
Silence Alert on nodeAll Roomschild1*httpcheck_posthog_netdata_cloud.request_status***Silences specific Alert on child1 node
Disk Space Alerts on mount pointAll Rooms**disk_space_usagedisk.spacedisk_space_opt_baddisk*Silences specific Alert instance on all nodes /opt/baddisk

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