From 55d24a2c0c4a3fac527871fdba1f9625ac13b818 Mon Sep 17 00:00:00 2001
From: Turan Almammadov <16321061+turanalmammadov@users.noreply.github.com>
Date: Wed, 25 Feb 2026 03:26:11 +0400
Subject: [PATCH] [Task] Add node alarm monitoring metrics for RabbitMQ

- Add node_alarms metric set to app-rabbitmq.yml using /api/nodes endpoint
- Exposes: node name, disk_free_alarm, mem_alarm, running status, node type
- Update docs: home/docs/help/rabbitmq.md (English)
- Update docs: home/i18n/zh-cn/.../rabbitmq.md (Chinese)

This allows operators to detect disk space and memory pressure alarms
on RabbitMQ cluster nodes proactively.

Co-authored-by: Cursor <cursoragent@cursor.com>
---
 .../main/resources/define/app-rabbitmq.yml    | 51 +++++++++++++++++++
 home/docs/help/rabbitmq.md                    | 10 ++++
 .../current/help/rabbitmq.md                  | 10 ++++
 3 files changed, 71 insertions(+)

diff --git a/hertzbeat-manager/src/main/resources/define/app-rabbitmq.yml b/hertzbeat-manager/src/main/resources/define/app-rabbitmq.yml
index bd8c34e8c8c..becfd8cecc3 100644
--- a/hertzbeat-manager/src/main/resources/define/app-rabbitmq.yml
+++ b/hertzbeat-manager/src/main/resources/define/app-rabbitmq.yml
@@ -661,3 +661,54 @@ metrics:
       parseType: jsonPath
       parseScript: '$.*'
 
+
+  - name: node_alarms
+    i18n:
+      zh-CN: 节点告警
+      en-US: Node Alarms
+      ja-JP: ノードアラーム
+    priority: 4
+    fields:
+      - field: name
+        type: 1
+        i18n:
+          zh-CN: 节点名称
+          en-US: Node Name
+          ja-JP: ノード名
+      - field: disk_free_alarm
+        type: 1
+        i18n:
+          zh-CN: 磁盘空间告警
+          en-US: Disk Free Alarm
+          ja-JP: ディスク空き容量アラーム
+      - field: mem_alarm
+        type: 1
+        i18n:
+          zh-CN: 内存告警
+          en-US: Memory Alarm
+          ja-JP: メモリアラーム
+      - field: running
+        type: 1
+        i18n:
+          zh-CN: 节点运行中
+          en-US: Running
+          ja-JP: ノード稼働中
+      - field: type
+        type: 1
+        i18n:
+          zh-CN: 节点类型
+          en-US: Node Type
+          ja-JP: ノードタイプ
+    protocol: http
+    http:
+      host: ^_^host^_^
+      port: ^_^port^_^
+      url: /api/nodes
+      method: GET
+      ssl: ^_^ssl^_^
+      authorization:
+        type: ^_^authType^_^
+        basicAuthUsername: ^_^username^_^
+        basicAuthPassword: ^_^password^_^
+      parseType: jsonPath
+      parseScript: '$.*'
diff --git a/home/docs/help/rabbitmq.md b/home/docs/help/rabbitmq.md
index 4dd30d94318..9efeda33554 100644
--- a/home/docs/help/rabbitmq.md
+++ b/home/docs/help/rabbitmq.md
@@ -123,3 +123,13 @@ keywords: [open source monitoring tool, open source rabbitmq monitoring tool, mo
 | message_bytes_unacknowledged | B           | Like message_bytes but counting only those messages delivered to clients but not yet acknowledged                                    |
 | message_bytes_ram            | B           | Like message_bytes but counting only those messages which are currently held in RAM                                                  |
 | message_bytes_persistent     | B           | Like message_bytes but counting only those messages which are persistent                                                             |
+
+#### Metric set：node_alarms
+
+| Metric name    | Metric unit | Metric help description                      |
+|----------------|-------------|----------------------------------------------|
+| name           | none        | RabbitMQ node name                           |
+| disk_free_alarm | none       | Whether disk free space alarm is triggered   |
+| mem_alarm      | none        | Whether memory alarm is triggered            |
+| running        | none        | Whether the node is running                  |
+| type           | none        | Node type (disc or ram)                      |
diff --git a/home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/rabbitmq.md b/home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/rabbitmq.md
index be554adf7aa..ba71022850a 100644
--- a/home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/rabbitmq.md
+++ b/home/i18n/zh-cn/docusaurus-plugin-content-docs/current/help/rabbitmq.md
@@ -123,3 +123,13 @@ keywords: [开源监控系统, 开源消息中间件监控, RabbitMQ消息中间
 | message_bytes_unacknowledged | B    | Like message_bytes but counting only those messages delivered to clients but not yet acknowledged                                    |
 | message_bytes_ram            | B    | Like message_bytes but counting only those messages which are currently held in RAM                                                  |
 | message_bytes_persistent     | B    | Like message_bytes but counting only those messages which are persistent                                                             |
+
+#### 指标集合：node_alarms
+
+| 指标名称        | 指标单位 | 指标帮助描述             |
+|-----------------|------|-------------------------|
+| name            | 无   | RabbitMQ节点名称         |
+| disk_free_alarm | 无   | 磁盘空间告警是否触发     |
+| mem_alarm       | 无   | 内存告警是否触发         |
+| running         | 无   | 节点是否运行中           |
+| type            | 无   | 节点类型(disc或ram)      |