summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorFotis Voutsas <fotis@netdata.cloud>2023-03-20 19:16:59 +0200
committerGitHub <noreply@github.com>2023-03-20 10:16:59 -0700
commit550b681f272edc3f4fdd4c43bb03f50fc6f4514d (patch)
tree19c0d9b7f58af586020dfee7794ade63e0aa2965 /docs
parent6f15318bb3ebb4cb09bf95dbea1932545e32473f (diff)
Update "View active alerts" documentation (#14766)
* initial commit, formatting comes next * format and spell check the file * Change headings --------- Co-authored-by: Chris Akritidis <43294513+cakrit@users.noreply.github.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/monitor/view-active-alarms.md62
1 files changed, 33 insertions, 29 deletions
diff --git a/docs/monitor/view-active-alarms.md b/docs/monitor/view-active-alarms.md
index 727fbe2c77..523ae24951 100644
--- a/docs/monitor/view-active-alarms.md
+++ b/docs/monitor/view-active-alarms.md
@@ -1,33 +1,46 @@
# View active alerts
-Every Netdata Agent comes with hundreds of pre-installed health alarms designed to notify you when an anomaly or
-performance issue affects your node or the applications it runs.
+Netdata comes with hundreds of pre-configured health alerts designed to notify you when an anomaly or performance issue affects your node or the applications it runs.
-## Netdata Cloud
+From the Alerts tab you can see all the active alerts in your War Room. You will be presented with a table having information about each alert that is in warning and critical state.
+You can always sort the table by a certain column by clicking on the name of that column, and use the gear icon on the top right to control which columns are visible at any given time.
-A War Room's [indicator](https://learn.netdata.cloud/docs/cloud/war-rooms#indicators) displays the number of
-active `critical` (red) and `warning` (yellow) alerts for the nodes in this War Room. Click on either the critical or
-warning badges to open a pre-filtered modal displaying only those types of active alerts.
+![image](https://user-images.githubusercontent.com/70198089/226340574-7e138dc7-5eab-4c47-a4a9-5f2640e38643.png)
-![The Alarms panel in Netdata Cloud](https://user-images.githubusercontent.com/1153921/108564747-d2bfbb00-72c0-11eb-97b9-5863ad3324eb.png)
+### Filter alerts
-The Alarms panel lists all active alarms for nodes within that War Room, and tells you which chart triggered the alarm,
-what that chart's current value is, the alarm that triggered it, and when the alarm status first began.
+From this view, you can also filter alerts with the right hand bar. More specifically you can filter:
-Use the input field in the Alarms panel to filter active alarms. You can sort by the node's name, alarm, status, chart
-that triggered the alarm, or the operating system. Read more about the [filtering
-syntax](https://learn.netdata.cloud/docs/cloud/war-rooms#node-filter) to build valuable filters for your infrastructure.
+- Alert status
+ - Filter based on the status of the alerts (e.g. Warning, Critical)
+- Alert class
+ - Filter based on the class of the alert (e.g. Latency, Utilization, Workload etc.)
+- Alert type & component
+ - Filter based on the alert's type (e.g. System, Web Server) and component (e.g. CPU, Disk, Load)
+- Alert role
+ - Filter by the role that the alert is set to notify (e.g. Sysadmin, Webmaster etc.)
+- Nodes
+ - Filter the alerts based on the nodes that are online, next to each node's name you can see how many alerts the node has, "critical" colored in red and "warning" colored in yellow
-Click on the 3-dot icon (`⋮`) to view active alarm information or navigate directly to the offending chart in that
-node's Cloud dashboard with the **Go to chart** button.
+### View alert details
-The active alarm information gives you details about the alarm that's been triggered. You can see the alarm's
-configuration, how it calculates warning or critical alarms, and which configuration file you could edit on that node if
-you want to tweak or disable the alarm to better suit your needs.
+By clicking on the name of an entry of the table you can access that alert's details page, providing you with:
-![Active alarm details in Netdata
-Cloud](https://user-images.githubusercontent.com/1153921/108564813-f08d2000-72c0-11eb-80c8-b2af22a751fd.png)
+- Latest and Triggered time values
+- The alert's description
+- A link to the Community forum's alert page
+- The chart at the time frame that the alert was triggered
+- The alert's information: Node name, chart ID, type, component and class
+- Configuration section
+- Instance values - Node Instances
+![image](https://user-images.githubusercontent.com/70198089/226339928-bae60140-0293-42cf-9713-ac4901708aba.png)
+
+At the bottom of the panel you can click the green button "View dedicated alert page" to open a [dynamic tab](https://github.com/netdata/netdata/blob/master/docs/quickstart/infrastructure.md#dynamic-tabs) containing all the info for this alert in a tab format, where you can also run correlations and go to the node's chart that raised the particular alert.
+
+![image](https://user-images.githubusercontent.com/70198089/226339794-61896c35-0b93-4ac9-92aa-07116fe63784.png)
+
+<!--
## Local Netdata Agent dashboard
Find the alarms icon ![Alarms
@@ -54,13 +67,4 @@ With the three icons beneath that and the **role** designation, you can:
The table on the right-hand side displays information about the health entity that triggered the alarm, which you can
use as a reference to [configure alarms](https://github.com/netdata/netdata/blob/master/health/REFERENCE.md).
-
-## What's next?
-
-With the information that appears on Netdata Cloud and the local dashboard about active alarms, you can [configure alarms](https://github.com/netdata/netdata/blob/master/health/REFERENCE.md) to match your infrastructure's needs or your team's goals.
-
-If you're happy with the pre-configured alarms, skip ahead to [enable
-notifications](https://github.com/netdata/netdata/blob/master/docs/monitor/enable-notifications.md) to use Netdata Cloud's centralized alarm notifications and/or
-per-node notifications to endpoints like Slack, PagerDuty, Twilio, and more.
-
-
+ -->