[doc] add help documentation for Alarms Center (#3181)

Co-authored-by: yunfan24 <[email protected]>
Co-authored-by: aias00 <[email protected]>

Author: 3 people

home/docs/help/alarm_center.md

@@ -0,0 +1,57 @@
+---
+id: alarm_center
+title: Alarm Center
+sidebar_label: Alarm Center
+keywords:
+  [open-source monitoring system, alarm center, alarm management, alarm display]
+---
+
+> The Alarm Center serves as a comprehensive visualization platform that displays all alarms after undergoing grouping, consolidation, suppression, and silencing processes. It encompasses both internally triggered threshold-based alarms and integrated third-party notifications.
+
+## Alarm Sources
+
+The HertzBeat Alarm Center manages notifications from two primary sources:
+
+1. Internal Threshold-Triggered Alarms
+   - Generated when monitoring metrics exceed predefined thresholds
+   - Directly correlated with monitoring tasks and threshold rules configured within the system
+   - Manageable through adjustment of monitoring parameters and threshold configurations
+2. Third-Party Integrated Alarms
+   - Received through API interfaces from external systems
+   - Compatible with various monitoring systems and alarm platforms
+   - Processed through identical workflow as internal alarms
+
+## Alarm Processing Mechanism
+
+Before appearing in the Alarm Center, all notifications undergo several processing stages:
+
+1. Grouping
+   - Categorizes related alarms based on source, type, severity, and other attributes (labels)
+   - Facilitates efficient management of high-volume alarms
+   - Supports customizable grouping rules for diverse scenarios
+2. Consolidation
+   - Mitigates notification fatigue from multiple similar alarms within short intervals
+   - Presents consolidated alarms in a streamlined format, eliminating redundancy
+3. Suppression
+   - Manages alarm dependencies
+   - Suppresses secondary alarms when primary alarms are triggered
+   - Supports configurable suppression rules based on alarm dependencies
+4. Silencing
+   - Temporarily mutes specific alarms during designated periods
+   - Ideal for system maintenance windows and known issue handling
+   - Enables time-based silence rule configuration
+
+## Alarm Center Interface
+
+![alarm_center](/img/docs/help/alarm-center-1.png)
+
+The Alarm Center provides a comprehensive view of all system alarms:
+
+1. Alarm Display
+   - Lists all alarms with crucial information including status, source, labels, and timestamps
+   - Offers detailed view functionality for comprehensive alarm information and context
+2. Search Functionality
+   - Enables rapid alarm identification
+   - Supports multiple search criteria (labels, annotations, alarm status)
+3. Alarm Management
+   - Alarm Deletion: Removes alarms no longer requiring attention

home/docs/help/guide.md

@@ -107,6 +107,8 @@ sidebar_label: Help Center
 
 > The triggered alarm information center provides query and filtering of alarm deletion, alarm processing, mark unprocessed, alarm level status, etc.
 
+More details see 👉 [Alarm center](alarm_center)
+
 ### Alarm configuration
 
 > The Metric threshold configuration provides the Metric threshold configuration in the form of expression, which can set the alarm level, trigger times, alarm notification template and whether it is enabled, correlation monitoring and other functions.

home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/alarm_center.md

@@ -0,0 +1,56 @@
+---
+id: alarm_center
+title: 告警中心
+sidebar_label: 告警中心
+keywords: [开源监控系统, 告警中心, 告警管理，告警显示]
+---
+
+> 告警中心是一个展示平台，用于显示所有经过分组、收敛、抑制、静默等处理的告警，包括由内部系统阈值触发的告警和第三方接入告警。
+
+## 告警来源
+
+HertzBeat 的告警中心管理来自两个主要来源的告警：
+
+1. 系统内部阈值触发的告警
+   - 当监控指标超过预定义阈值时生成
+   - 与系统中配置的监控任务和阈值规则直接相关
+   - 可以通过调整监控任务和阈值设置进行控制
+2. 第三方接入告警
+   - 通过 API 接口从外部系统接收
+   - 支持与其他监控系统或告警平台集成
+   - 与内部告警一样经过相同的处理流程
+
+## 告警处理机制
+
+在显示到告警中心之前，所有告警都会经过几个处理步骤：
+
+1. 分组
+   - 基于来源、类型、严重程度和其他属性（标签）对相关告警进行分类
+   - 帮助高效管理大量告警
+   - 支持针对不同场景的自定义分组规则
+2. 收敛
+   - 减少短时间内发生的多个类似告警产生的干扰
+   - 以更简洁的方式呈现收敛后的告警，避免信息冗余
+3. 抑制
+   - 处理告警之间的依赖关系
+   - 当关键告警触发时，可以抑制相关的次要告警
+   - 支持配置定义告警依赖关系的抑制规则
+4. 静默
+   - 在特定时间段内暂时屏蔽某些告警
+   - 适用于系统维护、已知问题处理等场景
+   - 可以基于时间设置静默规则
+
+## 告警中心界面
+
+![alarm_center](/img/docs/help/alarm-center-1.png)
+
+告警中心提供了系统所有告警的全面视图：
+
+1. 告警显示
+   - 列出所有告警，包含告警状态、来源、标签和时间等关键信息
+   - 提供详细视图功能，显示完整的告警信息和上下文
+2. 搜索功能
+   - 帮助快速定位特定告警
+   - 支持多种搜索（标签、注解、告警状态等）
+3. 告警管理
+   - 告警删除：移除不再需要关注的告警

home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/guide.md

@@ -107,6 +107,8 @@ sidebar_label: 帮助入门
 
 > 已触发的告警信息中心，提供告警删除，告警处理，标记未处理，告警级别状态等查询过滤。
 
+详见 👉 [告警中心](alarm_center)
+
 ### 告警配置
 
 > 指标阈值配置，提供表达式形式的指标阈值配置，可设置告警级别，触发次数，告警通知模版和是否启用，关联监控等功能。

home/sidebars.json

@@ -23,28 +23,19 @@
             {
               "type": "category",
               "label": "extern-deploy",
-              "items": [
-                "start/baota-deploy",
-                "start/rainbond-deploy"
-              ]
+              "items": ["start/baota-deploy", "start/rainbond-deploy"]
             }
           ]
         },
         {
           "type": "category",
           "label": "upgrade",
-          "items": [
-            "start/1.6.0-update",
-            "start/upgrade"
-          ]
+          "items": ["start/1.6.0-update", "start/upgrade"]
         },
         {
           "type": "category",
           "label": "setting",
-          "items": [
-            "start/account-modify",
-            "start/custom-config"
-          ]
+          "items": ["start/account-modify", "start/custom-config"]
         },
         {
           "type": "category",
@@ -60,9 +51,7 @@
         {
           "type": "category",
           "label": "use-case",
-          "items": [
-            "start/ssl-cert-practice"
-          ]
+          "items": ["start/ssl-cert-practice"]
         }
       ]
     },
@@ -132,11 +121,7 @@
         {
           "type": "category",
           "label": "cache",
-          "items": [
-            "help/redis",
-            "help/memcached",
-            "help/valkey"
-          ]
+          "items": ["help/redis", "help/memcached", "help/valkey"]
         },
         {
           "type": "category",
@@ -160,9 +145,7 @@
         {
           "type": "category",
           "label": "server",
-          "items": [
-            "help/ipmi"
-          ]
+          "items": ["help/ipmi"]
         },
         {
           "type": "category",
@@ -212,55 +195,37 @@
         {
           "type": "category",
           "label": "webserver",
-          "items": [
-            "help/tomcat",
-            "help/jetty"
-          ]
+          "items": ["help/tomcat", "help/jetty"]
         },
         {
           "type": "category",
           "label": "cloud-native",
-          "items": [
-            "help/docker",
-            "help/kubernetes"
-          ]
+          "items": ["help/docker", "help/kubernetes"]
         },
         {
           "type": "category",
           "label": "llm",
-          "items": [
-            "help/openai"
-          ]
+          "items": ["help/openai"]
         },
         {
           "type": "category",
           "label": "aiConfig",
-          "items": [
-            "help/aiConfig"
-          ]
+          "items": ["help/aiConfig"]
         },
         {
           "type": "category",
           "label": "custom",
-          "items": [
-            "help/kafka_promql",
-            "help/influxdb_promql"
-          ]
+          "items": ["help/kafka_promql", "help/influxdb_promql"]
         },
         {
           "type": "category",
           "label": "network",
-          "items": [
-            "help/huawei_switch"
-          ]
+          "items": ["help/huawei_switch"]
         },
         {
           "type": "category",
           "label": "threshold",
-          "items": [
-            "help/alert_threshold",
-            "help/alert_threshold_expr"
-          ]
+          "items": ["help/alert_threshold", "help/alert_threshold_expr"]
         },
         {
           "type": "category",
@@ -284,6 +249,7 @@
         "help/plugin",
         "help/time_expression",
         "help/grafana_dashboard",
+        "help/alarm_center",
         "help/issue"
       ]
     },
@@ -307,44 +273,32 @@
         {
           "type": "category",
           "label": "jdbc",
-          "items": [
-            "advanced/extend-jdbc"
-          ]
+          "items": ["advanced/extend-jdbc"]
         },
         {
           "type": "category",
           "label": "ssh",
-          "items": [
-            "advanced/extend-ssh"
-          ]
+          "items": ["advanced/extend-ssh"]
         },
         {
           "type": "category",
           "label": "telnet",
-          "items": [
-            "advanced/extend-telnet"
-          ]
+          "items": ["advanced/extend-telnet"]
         },
         {
           "type": "category",
           "label": "jmx",
-          "items": [
-            "advanced/extend-jmx"
-          ]
+          "items": ["advanced/extend-jmx"]
         },
         {
           "type": "category",
           "label": "snmp",
-          "items": [
-            "advanced/extend-snmp"
-          ]
+          "items": ["advanced/extend-snmp"]
         },
         {
           "type": "category",
           "label": "NGQL",
-          "items": [
-            "advanced/extend-ngql"
-          ]
+          "items": ["advanced/extend-ngql"]
         }
       ]
     },
@@ -392,10 +346,7 @@
     {
       "type": "category",
       "label": "Others",
-      "items": [
-        "others/resource"
-      ]
+      "items": ["others/resource"]
     }
   ]
 }
-