Add AI-Powered Alert Configuration docs entry (#21482)
Co-authored-by: ilyam8 <ilya@netdata.cloud>
Kanela committed
Dec 22, 2025 at 13:47 UTC
319d611bc59eb913f0bf4cee405d29c07551d3be
2 files changed
+90
docs/.map/map.csv
+1
@@ -165,6 +165,7 @@ https://github.com/netdata/netdata/edit/master/src/health/REFERENCE.md,Alert Con
165
https://github.com/netdata/netdata/edit/master/src/web/api/health/README.md,Health API Calls,Published,Alerts & Notifications,,
166
,,,,,
167
https://github.com/netdata/netdata/edit/master/docs/category-overview-pages/machine-learning-and-assisted-troubleshooting.md,Netdata AI,Published,Netdata AI,,
168
+https://github.com/netdata/netdata/edit/master/docs/ai-powered-alert-configuration/ai-powered-alert-configuration.md,AI-Powered Alert Configuration,Published,Netdata AI,,
169
https://github.com/netdata/netdata/edit/master/docs/ml-ai/ai-insights.md,Insights,Published,Netdata AI/Insights,,
170
https://github.com/netdata/netdata/edit/master/docs/netdata-ai/insights/infrastructure-summary.md,Infrastructure Summary,Published,Netdata AI/Insights,,
171
https://github.com/netdata/netdata/edit/master/docs/netdata-ai/insights/performance-optimization.md,Performance Optimization,Published,Netdata AI/Insights,,
docs/ai-powered-alert-configuration/ai-powered-alert-configuration.md
new
+89
@@ -0,0 +1,89 @@
1
+# AI-Powered Alert Configuration
2
+
3
+## Overview
4
+
5
+Netdata has an incredibly powerful alerting engine that offers immense flexibility to build specific, intelligent alerts. However, mastering its syntax can feel like learning a new language.
6
+
7
+To ensure accessibility for every member on your engineering team, we created the AI-Powered Alert Configuration feature. A bridge between your intent and Netdata's syntax, letting you describe conditions in plain English while the AI handles the rest.
8
+
9
+## Capabilities
10
+
11
+### Creating production-ready alerts
12
+
13
+All you have to do to create production-ready alerts is to simply describe your goal in plain English. For example, if you want to get ahead of a disk filling up:
14
+
15
+**"Create an alert that warns me when a disk will be more than 85% full in the next 24 hours, and goes critical if it is more than 95% full."**
16
+
17
+Netdata AI translates your request into a perfectly formatted, syntactically correct alert definition and presents it for your review.
18
+
19
+### Suggest what to alert on
20
+
21
+You can ask Netdata AI for intelligent suggestions based on the context of your infrastructure.
22
+
23
+Netdata AI will suggest what would be a suitable alert for a specific use-case or context.
24
+
25
+### Explain what every alert does
26
+
27
+Netdata ships with hundreds of pre-configured alerts. To get masterfull insights of their underlying logic:
28
+
29
+Click on any alert definition and ask Netdata AI to **Explain** this alert. It will break down the entire definition line by line.
30
+
31
+## AI credits consumption
32
+
33
+Just like other Netdata AI functionality, usage is based on AI credits. You get 10 monthly complementary credits with a Business subscription, and you can top up credits yourself based on your needs. You also get 10 free credits on the free trial to experiment with.
34
+
35
+- **Alert creation**: 0.2 credits per run (create up to 5 alerts per AI credit)
36
+- **Alert suggestion**: 0.2 credits per run (up to 5 suggestions per AI credit)
37
+- **Alert explanation**: Free to use
38
+
39
+:::info
40
+
41
+Track your AI credit usage from `Settings → Usage & Billing → AI Credits`.
42
+
43
+:::
44
+
45
+## How to access
46
+
47
+You'll find these new AI capabilities directly within the alert configuration workflow in Netdata Cloud.
48
+
49
+### From any chart
50
+
51
+**Step 1:** Click on the **alert bell icon** (locate it by navigating your cursor on any chart)
52
+**Step 2:** Click on **+ Add alert**
53
+**Step 3:** Describe the alert you want to create
54
+
55
+You can now seamlessly:
56
+
57
+- Create alerts using natural language
58
+- Get AI suggestions for what to monitor
59
+- Explain existing alerts
60
+
61
+### From the Alerts tab
62
+
63
+Click on **"New Alert"** from the alerts tab to access the AI-powered alert creation workflow.
64
+
65
+### Alternative: Manual configuration
66
+
67
+You can always use the manual dynamic configuration alert wizard, which gives you full control over every parameter.
68
+
69
+## Requirements
70
+
71
+- **Subscription:** Business plan or Free Trial
72
+- **Access:** Netdata Cloud account with appropriate permissions
73
+
74
+## Availability
75
+
76
+This feature is available today for all users on a Business plan or a free trial.
77
+
78
+## See also
79
+
80
+- [Alert Troubleshooting](/docs/troubleshooting/troubleshoot.md) - AI-powered alert investigation
81
+- [Netdata AI Overview](/docs/category-overview-pages/machine-learning-and-assisted-troubleshooting.md) - Complete AI capabilities guide
82
+
83
+By letting Netdata AI handle the syntactic complexity, we're lowering the barrier to entry for effective alerting and freeing up your team to focus on what matters: building reliable, high-performance systems.
84
+
85
+:::note
86
+
87
+Despite our best efforts to reduce inaccuracies, AI responses may sometimes be incorrect. Please review generated configurations before deploying to production systems.
88
+
89
+:::