Apusic文档中心
首页
  • 应用服务器 AAS
  • 负载均衡器 ALB
  • 分布式消息队列 ADMQ
  • 分布式缓存 AMDC
  • 分布式配置中心 ADCC
  • Java开发工具包软件 AJDK
  • 搜索引擎 ASE
  • 中间件云平台 ACP
  • 统一管理平台 AUMP
  • 云原生中间件管理 ACMP
  • DevOps平台 ADOP
  • 许可授权中心 ACLS
  • Copilot智能问答系统 ACS
  • 监控平台 AMP
  • 智能日志 AILP
  • 应用性能管理 AAPM
  • 智能告警 AAlarm
  • 金蝶Apusic AI 极光
  • 主数据管理 AMDM
  • 数据交换平台 ADXP
  • 企业服务总线 AESB
  • 数据智脑 ADPR
  • 服务治理 ASGP
  • 统一身份管理 AIDM
  • 标准模板
  • Markdown教程 (opens new window)
  • VuePress官方社区 (opens new window)
  • 帮助
贡献文档 (opens new window)
首页
  • 应用服务器 AAS
  • 负载均衡器 ALB
  • 分布式消息队列 ADMQ
  • 分布式缓存 AMDC
  • 分布式配置中心 ADCC
  • Java开发工具包软件 AJDK
  • 搜索引擎 ASE
  • 中间件云平台 ACP
  • 统一管理平台 AUMP
  • 云原生中间件管理 ACMP
  • DevOps平台 ADOP
  • 许可授权中心 ACLS
  • Copilot智能问答系统 ACS
  • 监控平台 AMP
  • 智能日志 AILP
  • 应用性能管理 AAPM
  • 智能告警 AAlarm
  • 金蝶Apusic AI 极光
  • 主数据管理 AMDM
  • 数据交换平台 ADXP
  • 企业服务总线 AESB
  • 数据智脑 ADPR
  • 服务治理 ASGP
  • 统一身份管理 AIDM
  • 标准模板
  • Markdown教程 (opens new window)
  • VuePress官方社区 (opens new window)
  • 帮助
贡献文档 (opens new window)
文档中心
  • 金蝶Apusic应用服务器

  • 金蝶Apusic负载均衡器

  • 金蝶Apusic分布式消息队列

    • 产品白皮书
    • Product Whitepaper
    • 產品白皮書
    • 产品更新说明
    • 统一管控台

    • V2.0.6(最新)

    • V2.0.6_for_kafka

    • V2.0.6_for_rabbitmq

      • 产品简介
      • 功能与技术规格
      • 安装手册
      • 快速使用手册
      • 管控台用户手册
      • 消息引擎用户手册
      • 开发手册
      • 迁移手册
      • 运维手册
      • 性能优化手册
      • 极简运维手册
      • English

      • 繁體中文

        • 產品介紹
        • 技術規範
        • 安裝手冊
        • 快速入門
        • 管控台使用者手冊
        • 核心引擎使用者手冊
        • 開發手冊
        • 遷移手冊
        • 維運手冊
        • 效能調優
        • 快速操作指南
    • V2.0.6_for_rocketmq

    • V2.0.6_for_MQTT

    • V2.0.5

    • V2.0.4

    • V2.0.3

  • 金蝶Apusic分布式缓存

  • 金蝶Apusic分布式配置中心

  • 金蝶Apusic Java开发工具包软件

  • 金蝶Apusic全文检索

管控台使用者手冊

# 前言

本文件為金蝶 Apusic 分散式訊息佇列 for RabbitMQ(Apusic Distributed Message Queue,簡稱:ADMQ for RabbitMQ)管控台產品的用戶手冊,詳細介紹 ADMQ for RabbitMQ 產品 Web 管控台的功能使用、配置方法及管理操作等內容。

# 適用對象

本文件適用於 IT 資訊化業務負責人、研發經理、軟體專案經理、軟體架構師、運維工程師。

# 相關文件

了解更多 ADMQ for RabbitMQ 產品相關的資訊,請參閱以下 ADMQ for RabbitMQ 產品手冊文件集:

序號 手冊文件 說明
1 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 快速使用手冊 簡單介紹了如何快速上手使用 ADMQ for RabbitMQ 。
2 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 安裝手冊 詳細介紹如何在各作業系統上安裝 ADMQ for RabbitMQ,以及 ADMQ for RabbitMQ 服務啟停等操作。
3 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 訊息引擎用戶手冊 詳細介紹 ADMQ for RabbitMQ 訊息引擎相關功能的使用、配置、管理及配套工具的使用方法。
4 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 管控台用戶手冊 詳細介紹 ADMQ for RabbitMQ 管控台相關功能的使用和操作說明。
5 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 開發手冊 詳細介紹基於各開發語言進行 ADMQ for RabbitMQ 客戶端應用開發的說明。
6 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 遷移手冊 詳細介紹從 RabbitMQ 遷移到 ADMQ for RabbitMQ 的說明。
7 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 運維手冊 詳細介紹 ADMQ for RabbitMQ 的監控、運維、安全強化等運維說明。
8 金蝶 Apusic 分散式訊息佇列 for RabbitMQ 效能最佳化手冊 詳細介紹 ADMQ for RabbitMQ 效能調校的說明。

# 技術支援

ADMQ for RabbitMQ 產品提供全面的技術支援服務,您可以透過以下方式獲得技術支援:

  • 網址:www.apusic.com
  • 電話:400-855-5800
  • 信箱:support@apusic.com
  • 金蝶雲社群:https://vip.kingdee.com/?productId=73&productLineId=14&lang=zh-CN

您在取得技術支援時,請提供如下資訊:

  1. 您的姓名
  2. 公司資訊與聯絡方式
  3. 作業系統及其版本
  4. 產品版本號
  5. 出現異常及錯誤的日誌、截圖等詳細資訊

# 版本變更說明

版本 發布日期 修訂說明
V2.0.6 2026-06-23 初始版本,介紹 ADMQ for RabbitMQ 管控台的登入入口、介面佈局、虛擬主機/交換器/佇列/路由/MQ 用戶管理、監控統計、外掛與策略及常見問題等內容。

# 術語說明

術語 說明
Cluster RabbitMQ 叢集,由多個節點組成的訊息服務叢集
Node RabbitMQ 叢集中的單一服務節點
Vhost 虛擬主機,用於隔離不同業務系統的資源
User RabbitMQ 管理用戶,用於客戶端連線認證
Exchange 交換器,用於接收和路由訊息
Queue 佇列,用於儲存訊息
Binding 綁定關係,用於定義 Exchange 和 Queue 的路由關係
Routing Key 路由鍵,用於訊息投遞匹配
Permission 用戶在指定 Vhost 下的存取權限

# 概述

ADMQ for RabbitMQ 管控台分為系統管理與運維管理,系統管理主要用於核心引擎的接入,接入後可登入運維管理側檢視引擎狀態,並對引擎進行管理維護。

用戶需先進入系統管理側進行叢集配置與對接,然後在運維管理側進行叢集管理。

# 運行環境

ADMQ for RabbitMQ 管控台透過 Web 瀏覽器存取,建議使用 Chrome、Firefox、Edge 等現代瀏覽器。管控台服務隨 ADMQ for RabbitMQ 產品一起部署,具體的安裝步驟、服務啟停及埠配置請參閱《金蝶 Apusic 分散式訊息佇列 for RabbitMQ 安裝手冊》。

  • 伺服器端:已正確安裝並啟動 ADMQ for RabbitMQ 訊息引擎及管控台服務。
  • 用戶端:能夠存取管控台伺服器 IP 及埠的電腦,解析度建議 1920×1080 及以上。

# 管理面入口

# 存取位址

在瀏覽器網址列輸入以下 URL 進入 ADMQ for RabbitMQ 管控台登入頁面:

http://{console_ip}:12305
1

其中 {console_ip} 為管控台服務所在伺服器的 IP 位址或網域名稱,預設埠為 12305(若安裝時自訂了埠,請使用實際埠)。

image-20260923095756473

# 登入流程

  1. 開啟瀏覽器,輸入上述存取位址,進入登入頁面。
  2. 輸入預設帳號 admq 及初始密碼(首次安裝後預設密碼為 admq,具體以實際部署為準)。
  3. 點選 「登入」 按鈕。
  4. 首次登入時,系統會強制要求修改初始密碼,請按頁面提示設定符合安全策略的新密碼並重新登入。

安全注意事項:首次登入後請立即修改預設密碼;日常使用中應遵循最小權限原則,為不同角色分配僅滿足業務需要的權限,並定期審計帳號與權限配置。

# 預設帳號與權限

ADMQ for RabbitMQ 管控台預置預設管理員帳號 admq,用於系統管理側和運維管理側的初始登入。預設帳號具備以下權限:

帳號 初始密碼 適用場景 權限範圍
admq admq(首次登入需修改) 系統管理員 / 運維管理員 系統管理側:叢集接入、系統配置;運維管理側:虛擬主機、交換器、佇列、路由、MQ 用戶、監控、外掛策略等全部操作權限

實際生產環境建議在完成初始化後,建立獨立的管理員帳號並停用或修改預設帳號,避免使用預設帳號進行日常運維。

# 介面佈局簡介

登入成功後,根據當前帳號權限進入對應的管理介面:

  • 系統管理側:主要用於核心引擎的接入配置。接入叢集後,可在運維管理側檢視引擎狀態並進行管理維護。
  • 運維管理側:主要用於日常資源管理與運維監控,包括虛擬主機、交換器、佇列、路由、MQ 用戶、監控儀表板、外掛與策略等模組。

用戶需先進入系統管理側完成叢集配置與對接,然後在運維管理側進行叢集管理。

# 虛擬主機管理

# 功能入口

【虛擬主機】-【虛擬主機】

# 檢視虛擬主機列表

image-20260923095851195

列表展示以下資訊:

欄位 說明
名稱 虛擬主機標識,點選可進入詳情頁
MQ 用戶 有權限存取該虛擬主機的用戶列表
標籤 自訂標籤,用於分類標識
描述 虛擬主機的描述資訊
預設佇列類型 該虛擬主機下新建佇列的預設類型
建立時間 建立時間

# 建立虛擬主機

  1. 點選列表左上角的 「新增」 按鈕
  2. 填寫表單:
    • 名稱(必填):只能包含英文、數字、_、-、. 和 /,長度不超過 64 字元
    • 標籤(可選):按 Enter 新增多個標籤
    • 預設佇列類型:選擇 Classic / Quorum / Stream
    • 描述(可選):長度不超過 128 字元
  3. 點選 「確認」 儲存

# 編輯虛擬主機

點選行末的 「編輯」 按鈕,可修改描述資訊。名稱和預設佇列類型建立後不可修改。

根虛擬主機 / 不可編輯和刪除。

# 刪除虛擬主機

點選行末的 「刪除」 按鈕,確認後刪除。刪除虛擬主機將串聯刪除其下的所有交換器、佇列和綁定關係,請謹慎操作。

# 權限管理

點選行末的 「權限」 按鈕,進入該虛擬主機的權限分配頁面,可為不同 MQ 用戶配置存取權限(配置、讀、寫)。

# 虛擬主機詳情

點選虛擬主機名稱,進入詳情頁,可檢視該虛擬主機下的資源概覽、交換器列表、佇列列表、綁定關係等。

# 交換器管理

# 功能入口

【資源管理】-【交換器】

# 檢視交換器列表

image-20260923095906429

支援按以下條件篩選:

  • 包含內部交換器:勾選後顯示系統內部交換器(如 amq.direct、amq.topic 等)
  • 虛擬主機:按虛擬主機過濾
  • 名稱:按交換器名稱模糊搜尋

列表欄位說明:

欄位 說明
虛擬主機 所屬虛擬主機
名稱 交換器名稱,點選可檢視詳情,支援一鍵複製
類型 Direct / Topic / Fanout / Headers
持久化 Durable(重啟後保留)/ Transient(重啟後遺失)
自動刪除 是(無綁定時自動刪除)/ 否
描述 描述資訊
建立時間 建立時間

# 建立交換器

  1. 點選 「新增」 按鈕
  2. 填寫表單:
    • 虛擬主機(必填):選擇所屬虛擬主機
    • 名稱(必填):交換器唯一標識,建立後不可修改
    • 類型(必填):選擇交換器類型
    • 持久化(必填):是否持久化
    • 自動刪除(必填):是否自動刪除
    • 內部(必填):是否為內部交換器(內部交換器不能被客戶端直接發布訊息)
    • 描述(可選)
    • 自訂參數(可選):支援新增 Key-Value 形式的自訂參數,Value 類型可選 String / Number / List / Boolean
  3. 點選 「確認」 儲存

# 傳送訊息

點選行末的 「傳送訊息」 按鈕,可向指定交換器傳送測試訊息:

  • 路由鍵:訊息的路由鍵
  • 訊息頭:訊息頭
  • 訊息屬性:可選,如持久化標記、過期時間等
  • 訊息內容:訊息內容

此功能常用於除錯和驗證路由規則是否正確。

# 編輯交換器

僅支援修改描述和自訂參數。名稱、類型、持久化等核心屬性建立後不可修改。

# 刪除交換器

點選行末的 「刪除」 按鈕。刪除前請確保該交換器沒有活躍的綁定關係,否則可能導致訊息遺失。

系統內部交換器(allowModify=false)不可刪除。

# 同步交換器

點選左上角 「同步」 按鈕,可將 RabbitMQ 叢集中實際存在的交換器與平台資料庫進行比對和同步:

  1. 選擇需要同步的虛擬主機
  2. 系統將展示差異預覽:新增(叢集有但平台無)、刪除(平台有但叢集無)、更新(雙方存在差異)
  3. 勾選需要同步的項目,點選 「確認同步」

建議在叢集有變更(如透過其他工具建立了交換器)後執行同步,確保平台資料與叢集一致。

# 佇列管理

# 功能入口

【資源管理】-【佇列】

# 檢視佇列列表

image-20260923095932535

支援按虛擬主機和名稱篩選。列表欄位說明:

欄位 說明
虛擬主機 所屬虛擬主機
名稱 佇列名稱,點選可進入詳情,支援一鍵複製
類型 Classic / Quorum / Stream
狀態 正常 / 異常
訊息總數 佇列中當前訊息數量
未確認數 已投遞但未確認的訊息數量
訊息速率 每秒訊息變化速率
描述 描述資訊
建立時間 建立時間

# 建立佇列

  1. 點選 「新增」 按鈕
  2. 填寫表單:
    • 虛擬主機(必填)
    • 名稱(必填):佇列唯一標識,建立後不可修改
    • 佇列類型:
      • Default:使用虛擬主機的預設佇列類型
      • Classic:經典佇列,可配置持久化和自動刪除
      • Quorum:仲裁佇列,強制持久化,不可自動刪除
      • Stream:串流佇列,強制持久化,不可自動刪除
    • 持久化(Classic / Default 類型時可選)
    • 自動刪除(僅 Classic 類型可選)
    • 描述(可選)
    • 自訂參數(可選)
  3. 點選 「確認」 儲存

# 傳送訊息

點選行末的 「傳送訊息」 按鈕,可向指定佇列直接傳送訊息(不經過交換器路由)。

# 清空佇列

點選行末的 「清空」 按鈕,將刪除佇列中的所有訊息。此操作不可復原,請謹慎使用。

# 編輯佇列

僅支援修改描述和自訂參數。

# 刪除佇列

點選行末的 「刪除」 按鈕。刪除佇列將同時刪除佇列中的所有訊息。

# 同步佇列

與交換器同步邏輯相同,用於將平台佇列資料與叢集實際狀態對齊。

# 路由管理

# 功能入口

【資源管理】-【路由管理】

# 檢視路由列表

image-20260923100103557

支援多條件組合篩選:

  • 虛擬主機:選擇所屬虛擬主機
  • 交換器:選擇來源交換器(需先選擇虛擬主機)
  • 名稱:按路由名稱模糊搜尋
  • 路由鍵:按路由鍵模糊搜尋

列表欄位說明:

欄位 說明
虛擬主機 所屬虛擬主機
名稱 路由綁定名稱
來源交換器 訊息來源交換器
綁定目標 訊息目標(佇列或交換器)
目標類型 交換器 / 佇列
路由鍵 匹配規則
參數 額外匹配參數
描述 描述
建立時間 建立時間

# 建立路由綁定

  1. 點選 「新增」 按鈕
  2. 填寫表單:
    • 虛擬主機(必填)
    • 來源交換器(必填):選擇訊息來源交換器
    • 目標類型(必填):交換器 或 佇列
    • 目標(必填):選擇具體的目標交換器或佇列
    • 路由鍵(可選):根據交換器類型填寫
      • Direct 類型:精確匹配值
      • Topic 類型:支援 * 和 # 萬用字元
      • Fanout 類型:可留空(忽略路由鍵)
    • 參數(可選):Headers 類型交換器需填寫 Header 匹配參數
    • 描述(可選)
  3. 點選 「確認」 儲存

# 編輯路由綁定

可修改目標、路由鍵、參數和描述。

# 刪除路由綁定

點選行末的 「刪除」 按鈕。刪除後,匹配該綁定的訊息將不再路由到對應目標。

# 同步路由綁定

與交換器/佇列同步邏輯相同。

# MQ 用戶管理

# 功能入口

【用戶】-【MQ 用戶】

# 檢視用戶列表

image-20260923100140553

欄位 說明
名稱 用戶名,點選可進入詳情
可存取虛擬主機 該用戶有權限存取的虛擬主機列表
已設定密碼 是 / 否
描述 描述資訊

# 建立用戶

  1. 點選 「新增」 按鈕
  2. 填寫表單:
    • 用戶名(必填):不能包含空格及 @#&* 等特殊字元,建立後不可修改
    • 描述(可選)
    • 存取類型:
      • 密碼鑑權存取:需要設定密碼(至少 6 個字元)
      • 無密碼存取:無需密碼即可連線
  3. 點選 「確認」 儲存

# 編輯用戶

可修改描述、存取類型和密碼。

用戶名建立後不可修改。

# 刪除用戶

點選行末的 「刪除」 按鈕。刪除用戶後,該用戶的所有連線將被中斷。

# 權限管理

點選行末的 「權限」 按鈕,進入權限配置頁面。可為該用戶分配不同虛擬主機的存取權限:

  • 配置權限(configure):建立/刪除資源(交換器、佇列、綁定)
  • 讀權限(read):消費訊息、檢視資源資訊
  • 寫權限(write):發布訊息

正規表示式 .* 表示匹配所有資源。可填寫更精確的正規表示式來限制存取範圍。

# 監控與統計

# 連線監控

# 功能入口

【監控運維】-【連線監控】

# 檢視連線列表

即時展示當前叢集中的所有用戶端連線:

欄位 說明
虛擬主機 連線所屬的虛擬主機
名稱 連線標識(格式:host:port)
MQ 用戶 連線使用的用戶名
狀態 運行中 / 連線中 / 限流 / 阻塞中 / 關閉中 等
協定 使用的協定版本
通道 該連線上的通道數量
連線時間 連線建立的時間

支援按虛擬主機和連線名稱篩選。

# 強制關閉連線

點選行末的 「強制關閉」 按鈕,可立即中斷指定連線。連線關閉後不可復原,用戶端需要重新建立連線。

# 通道監控

# 功能入口

【監控運維】-【通道監控】

# 檢視通道列表

通道(Channel)是輕量級的連線複用單元,一個 TCP 連線上可以建立多個通道。

欄位 說明
虛擬主機 通道所屬的虛擬主機
通道名稱 通道標識
MQ 用戶 使用該通道的用戶
狀態 運行中 / 空閒 / 阻塞 / 關閉中
消費者數 該通道上的消費者數量
未確認訊息 該通道上未確認的訊息數量

支援按虛擬主機和通道名稱篩選。

連線監控和通道監控主要用於問題排查,如定位異常連線、檢視消費延遲等。

# 監控儀表板

# 功能入口

【監控運維】-【監控儀表板】

# 時間範圍選擇

頁面頂部提供時間範圍選擇器,支援快速選項(最近1小時、最近6小時、最近1天等)和自訂時間範圍。

# 監控維度

監控儀表板分為五個標籤頁:

# 概覽

展示叢集整體運行狀況,包括:

  • 節點數量、佇列總數、連線總數
  • 訊息吞吐量趨勢圖(發布/消費速率)
  • 叢集健康狀態
# 節點

展示各節點的資源使用情況:

  • CPU 使用率
  • 記憶體使用率
  • 磁碟使用率
  • Erlang 處理序數
  • 檔案描述子使用情況
# 佇列

展示佇列相關的監控指標:

  • 各佇列訊息堆積趨勢
  • 訊息消費速率
  • 消費者數量變化
# 連線

展示連線相關的監控指標:

  • 連線數趨勢
  • 各虛擬主機的連線分佈
# 交換器

展示交換器相關的監控指標:

  • 訊息入站/出站速率
  • 各交換器的訊息吞吐量

監控資料來源於 RabbitMQ 的管理外掛(Management Plugin),資料重新整理頻率約為 5 秒。

# 訊息統計報表

# 功能入口

【監控運維】-【訊息統計報表】

# 檢視統計結果

支援兩種統計維度:

  • 叢集維度:按日期聚合整個叢集的訊息指標
  • 佇列維度:按日期 + 佇列聚合訊息指標

統計指標包括:

指標 說明
發布訊息數 生產者發布到叢集/佇列的訊息數量
投遞訊息數 投遞給消費者的訊息數量
確認訊息數 消費者確認的訊息數量
訊息位元組數 訊息佔用的總位元組數
入站位元組數 流入叢集的總位元組數(叢集維度)
出站位元組數 流出叢集的總位元組數(叢集維度)

# 匯出報表

點選 「匯出」 按鈕,可將當前查詢結果匯出為 Excel 檔案。

# 定時統計任務

如需按固定週期(如每小時、每天)自動統計訊息資料,請聯絡管理員配置定時統計任務。

# 外掛與策略

# 外掛管理

# 功能入口

【設定】-【外掛管理】

# 檢視外掛狀態

外掛管理頁面以表格形式展示叢集中各外掛在各節點上的運行狀態:

欄位 說明
名稱 外掛英文標識
中文名稱 外掛中文描述
描述 外掛功能說明
節點列 每個節點一列,顯示此外掛在該節點上是否載入運行

外掛管理頁面僅提供檢視功能,外掛的啟用/停用需要透過叢集運維操作完成。

# 策略配置

# 功能入口

【設定】-【策略配置】

# 什麼是策略(Policy)

策略是 RabbitMQ 中用於批次配置佇列/交換器參數的機制。透過策略,可以為匹配特定模式(Pattern)的佇列或交換器自動套用一組參數,而無需逐個配置。

常見策略用途:

  • 設定佇列的死信交換器(Dead Letter Exchange,DLX)
  • 設定佇列的訊息過期時間(Time To Live,TTL)
  • 設定佇列的最大長度限制
  • 設定**聯邦(Federation)**和 **RabbitMQ 資料搬運外掛(Shovel)**相關參數
  • 配置 Quorum 佇列的副本數

# 檢視策略列表

支援按虛擬主機篩選。列表欄位說明:

欄位 說明
虛擬主機 策略生效的虛擬主機
策略名 策略標識
Pattern 匹配正規表示式,如 ^order.* 匹配所有以 order 開頭的佇列/交換器
應用對象 queues(佇列)/ exchanges(交換器)/ all(全部)
定義 策略參數定義(JSON 格式)
優先級 數值越大優先級越高,當多個策略匹配同一資源時,高優先級策略生效

# 建立策略

  1. 點選 「新增策略」 按鈕
  2. 填寫表單:
    • 虛擬主機(必填)
    • 策略名(必填)
    • Pattern(必填):用於匹配佇列/交換器名稱的正規表示式
    • 應用對象(必填):queues / exchanges / all
    • 定義(必填):策略參數,以 Key-Value 形式填寫
    • 優先級(必填):數字,預設 0
  3. 點選 「確認」 儲存

# 編輯策略

點選行末的 「編輯」 按鈕,可修改策略的所有欄位。

# 刪除策略

點選行末的 「刪除」 按鈕。刪除策略後,被該策略管理的佇列/交換器將恢復預設配置。

# 常見問題

# Q1: 為什麼建立了交換器/佇列但在列表中看不到?

可能原因:

  1. 虛擬主機篩選 —— 檢查是否選擇了正確的虛擬主機
  2. 未勾選「包含內部」 —— 系統內部交換器預設不顯示,需勾選「包含內部交換器」
  3. 資料未同步 —— 如果透過命令列工具(bin/admq rabbitmq admin)直接建立,需點選 「同步」 按鈕將資料同步到平台

# Q2: 如何檢視某個佇列的訊息內容?

訊息查詢功能目前暫未開放。如需檢視訊息,建議:

  1. 透過 RabbitMQ 原生管理介面檢視
  2. 使用消費者用戶端拉取訊息(注意消費後訊息會被移除)

# Q3: Quorum 佇列和 Classic 佇列有什麼區別?

特性 Classic Quorum
持久化 可選 強制持久化
自動刪除 可選 不支援
高可用 需配置鏡像佇列 原生基於 Raft(共識演算法)多副本
適用場景 通用 對資料安全要求高的場景

# Q4: 傳送訊息時提示「無法路由」?

可能原因:

  1. 交換器類型與路由鍵不匹配(如 Fanout 交換器不應設定路由鍵)
  2. 沒有綁定關係將交換器與佇列關聯
  3. 路由鍵與綁定時的路由鍵不匹配

# Q5: 如何限制某個用戶只能存取特定虛擬主機?

  1. 進入 MQ 用戶 頁面
  2. 點選該用戶的 「權限」 按鈕
  3. 在權限配置頁面,僅勾選允許存取的虛擬主機,並設定合適的正規表示式限制資源範圍

# Q6: 佇列訊息堆積嚴重怎麼辦?

  1. 進入 監控儀表板 → 佇列 檢視堆積趨勢
  2. 檢查 通道監控 中對應佇列的消費者是否正常運行
  3. 確認消費者沒有因為處理慢或異常導致訊息未確認
  4. 必要時可擴容消費者實例或最佳化消費邏輯

# Q7: 同步按鈕的作用是什麼?

同步功能用於解決平台資料與 RabbitMQ 叢集實際狀態不一致的問題。場景包括:

  • 透過命令列工具(bin/admq rabbitmq admin)直接操作了叢集資源
  • 叢集發生故障復原後資料不一致
  • 首次接入已有資料的叢集

同步會比對平台資料庫和叢集實際狀態,展示差異並支援選擇性同步。

# 附錄

# 術語表

術語 說明
Vhost 虛擬主機(Virtual Host),用於隔離不同業務系統的資源
Exchange 交換器,用於接收生產者訊息並根據路由規則轉發
Queue 佇列,用於儲存訊息,等待消費者消費
Binding 綁定關係,定義 Exchange 與 Queue 之間的路由規則
Routing Key 路由鍵,訊息投遞時用於匹配綁定的關鍵字
DLX Dead Letter Exchange(死信交換器),用於接收無法正常投遞或處理的訊息
TTL Time To Live(存活時間),訊息或佇列中訊息的最大存活時間
Classic Queue 經典佇列,RabbitMQ 傳統佇列類型
Quorum Queue 仲裁佇列,基於 Raft 共識演算法實現多副本高可用
Stream Queue 串流佇列,適合高吞吐、持久化日誌場景
Federation RabbitMQ 聯邦外掛,用於跨叢集交換器和佇列的資料同步
Shovel RabbitMQ 資料搬運外掛,用於在叢集或節點之間可靠地搬運訊息
Raft 共識演算法(Raft),Quorum 佇列內部用於副本一致性協調
DLQ 死信佇列(Dead Letter Queue),常與 DLX 搭配使用

# 配置參考 / 參數速查表

參數 / 配置項 說明 預設值 / 範例
管控台存取 URL 瀏覽器存取位址 http://{console_ip}:12305
預設管理員帳號 系統管理側 / 運維管理側初始登入帳號 admq
預設管理員初始密碼 首次登入後需強制修改 admq
虛擬主機名稱長度 建立虛擬主機時的名稱限制 不超過 64 字元
佇列名稱長度 建立佇列時的名稱限制 不超過 255 字元
策略 Pattern 匹配佇列/交換器名稱的正規表示式 ^order.*
策略優先級 多個策略匹配同一資源時的生效順序 數值越大優先級越高,預設 0
監控資料重新整理頻率 監控儀表板資料重新整理週期 約 5 秒
訊息統計匯出格式 訊息統計報表匯出檔案格式 Excel
编辑页面 (opens new window)
#管控台用户手册

← 快速入門 核心引擎使用者手冊→

  • 浅色模式