@cryptotaxi247 / netdata-1 / commits / 4e1a9def3

docs: task class: improve_docs — add free-tier alert silencing/disabling (#22567)

* docs: update docs/how-to-disable-specific-alerts-without-paid-plan * docs: Execution completed * Apply suggestions from code review Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Potential fix for pull request finding Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com> * Update REFERENCE.md * Apply suggestion from @Ancairon --------- Co-authored-by: nedi-app[bot] <nedi-app[bot]@users.noreply.github.com> Co-authored-by: Fotis Voutsas <fotis@netdata.cloud> Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

nedi-app[bot] committed May 26, 2026 at 13:14 UTC 4e1a9def33157b11663484020fcb4ee433b2cd7c
3 files changed +24 -1
docs/dashboards-and-charts/alerts-tab.md
+8
@@ -67,6 +67,14 @@ In the **Raised Alerts** tab:
67 - Create a new [silencing rule](/docs/alerts-and-notifications/notifications/centralized-cloud-notifications/centralized-cloud-notifications-reference.md#alert-notification-silencing-rules).
68 - Ask AI to troubleshoot the alert.
69
70 +:::note
71 +
72 +Cloud alert silencing rules are available on Netdata Cloud for Community and Paid plans (anonymous access cannot create rules).
73 +
74 +Users can also silence or disable alerts at the Agent level by editing alert configuration. For example, set `to: silent` in the alert's `health.d/*.conf` file and run `sudo netdatacli reload-health` to stop notifications, or use `enabled alarms = !alert_name *` in `netdata.conf` to exclude specific alerts entirely (requires restarting the Agent). See [manual configuration](/src/health/REFERENCE.md) for step-by-step instructions.
75 +
76 +:::
77 +
78 ## Creating and Tuning Alerts
79
80 From the Alerts tab, you can create new alerts or tune existing ones:
docs/getting-started-netdata/guide.md
+1 -1
@@ -191,7 +191,7 @@ Configure alerts to reach you through:
191 **Quick Silence Options:**
192
193 - **Individual alerts** - Change `to: silent` in alert configuration
194 -- **Specific alerts** - Edit `netdata.conf` with `enabled alarms = !alert_name *`
194 +- **Specific alerts** - Edit `netdata.conf` with `enabled alarms = !alert_name *` (single) or `enabled alarms = !alert1 !alert2 *` (multiple — all exclusions before the wildcard), then restart the Agent
195 - **All alerts** - Set `enabled = no` in `[health]` section
196
197 **Temporary Control:** Use the Health Management API for dynamic control without config changes - perfect for maintenance windows.
src/health/REFERENCE.md
+15
@@ -200,6 +200,21 @@ In the `netdata.conf` `[health]` section, set `enabled` to `no`, and restart you
200
201 In the `netdata.conf` `[health]` section, use [pattern](/src/libnetdata/simple_pattern/README.md) exclusion with `enabled alarms = !oom_kill *` to load all alerts except `oom_kill`.
202
203 +To exclude multiple specific alerts, list all exclusions before the wildcard and restart the Agent to apply the `netdata.conf` change:
204 +
205 +```conf
206 +[health]
207 + enabled alarms = !oom_kill !disk_space_usage *
208 +```
209 +
210 +Restart your Netdata Agent after changing `netdata.conf` (`netdatacli reload-health` reloads health configuration files, but does not reload `netdata.conf`).
211 +
212 +:::warning
213 +
214 +Do **not** place `*` between exclusions (`!alert1 * !alert2 *` is incorrect — patterns are evaluated in order and the first match wins). When using exclusions, put all `!` patterns first, followed by a single trailing `*`.
215 +
216 +:::
217 +
218 You can also [edit the file where the alert is defined](#how-to-edit-health-configuration-files), comment out its definition, and [reload Netdata's health configuration](#how-to-reload-health-configuration).
219
220 #### Silence Individual Alert Notifications