RocketMQ叢集搭建
1. RocketMQ叢集搭建
1.1 各角色介紹
- Producer:訊息的傳送者;舉例:發信者
- Consumer:訊息接收者;舉例:收信者
- Broker:暫存和傳輸訊息;舉例:郵局
- NameServer:管理Broker;舉例:各個郵局的管理機構
- Topic:區分訊息的種類;一個傳送者可以傳送訊息給一個或者多個Topic;一個訊息的接收者可以訂閱一個或者多個Topic訊息
- Message Queue:相當於是Topic的分割槽;用於並行傳送和接收訊息
1.2 叢集搭建方式
1.2.1 叢集特點
-
NameServer是一個幾乎無狀態節點,可叢集部署,節點之間無任何資訊同步。
-
Broker部署相對複雜,Broker分為Master與Slave,一個Master可以對應多個Slave,但是一個Slave只能對應一個Master,Master與Slave的對應關係通過指定相同的BrokerName,不同的BrokerId來定義,BrokerId為0表示Master,非0表示Slave。Master也可以部署多個。每個Broker與NameServer叢集中的所有節點建立長連線,定時註冊Topic資訊到所有NameServer。
-
Producer與NameServer叢集中的其中一個節點(隨機選擇)建立長連線,定期從NameServer取Topic路由資訊,並向提供Topic服務的Master建立長連線,且定時向Master傳送心跳。Producer完全無狀態,可叢集部署。
-
Consumer與NameServer叢集中的其中一個節點(隨機選擇)建立長連線,定期從NameServer取Topic路由資訊,並向提供Topic服務的Master、Slave建立長連線,且定時向Master、Slave傳送心跳。Consumer既可以從Master訂閱訊息,也可以從Slave訂閱訊息,訂閱規則由Broker配置決定。
1.2.2 叢集模式
1)單Master模式
這種方式風險較大,一旦Broker重啟或者宕機時,會導致整個服務不可用。不建議線上環境使用,可以用於本地測試。
2)多Master模式
一個叢集無Slave,全是Master,例如2個Master或者3個Master,這種模式的優缺點如下:
- 優點:配置簡單,單個Master宕機或重啟維護對應用無影響,在磁碟配置為RAID10時,即使機器宕機不可恢復情況下,由於RAID10磁碟非常可靠,訊息也不會丟(非同步刷盤丟失少量訊息,同步刷盤一條不丟),效能最高;
- 缺點:單臺機器宕機期間,這臺機器上未被消費的訊息在機器恢復之前不可訂閱,訊息實時性會受到影響。
3)多Master多Slave模式(非同步)
每個Master配置一個Slave,有多對Master-Slave,HA採用非同步複製方式,主備有短暫訊息延遲(毫秒級),這種模式的優缺點如下:
- 優點:即使磁碟損壞,訊息丟失的非常少,且訊息實時性不會受影響,同時Master宕機後,消費者仍然可以從Slave消費,而且此過程對應用透明,不需要人工干預,效能同多Master模式幾乎一樣;
- 缺點:Master宕機,磁碟損壞情況下會丟失少量訊息。
4)多Master多Slave模式(同步)
每個Master配置一個Slave,有多對Master-Slave,HA採用同步雙寫方式,即只有主備都寫成功,才嚮應用返回成功,這種模式的優缺點如下:
- 優點:資料與服務都無單點故障,Master宕機情況下,訊息無延遲,服務可用性與資料可用性都非常高;
- 缺點:效能比非同步複製模式略低(大約低10%左右),傳送單個訊息的RT會略高,且目前版本在主節點宕機後,備機不能自動切換為主機。
1.3 雙主雙從叢集搭建
1.3.1 總體架構
訊息高可用採用2m-2s(同步雙寫)方式
1.3.2 叢集工作流程
- 啟動NameServer,NameServer起來後監聽埠,等待Broker、Producer、Consumer連上來,相當於一個路由控制中心。
- Broker啟動,跟所有的NameServer保持長連線,定時傳送心跳包。心跳包中包含當前Broker資訊(IP+埠等)以及儲存所有Topic資訊。註冊成功後,NameServer叢集中就有Topic跟Broker的對映關係。
- 收發訊息前,先建立Topic,建立Topic時需要指定該Topic要儲存在哪些Broker上,也可以在傳送訊息時自動建立Topic。
- Producer傳送訊息,啟動時先跟NameServer叢集中的其中一臺建立長連線,並從NameServer中獲取當前傳送的Topic存在哪些Broker上,輪詢從佇列列表中選擇一個佇列,然後與佇列所在的Broker建立長連線從而向Broker發訊息。
- Consumer跟Producer類似,跟其中一臺NameServer建立長連線,獲取當前訂閱Topic存在哪些Broker上,然後直接跟Broker建立連線通道,開始消費訊息。
1.3.3 伺服器環境
序號 | IP | 角色 | 架構模式 |
---|---|---|---|
1 | 192.168.1.144 | nameserver、brokerserver | Master1、Slave2 |
2 | 192.168.1.145 | nameserver、brokerserver | Master2、Slave1 |
1.3.4 Host新增資訊
vim /etc/hosts
配置如下:
# nameserver
192.168.1.144 rocketmq-nameserver1
192.168.1.145 rocketmq-nameserver2
# broker
192.168.1.144 rocketmq-master1
192.168.1.144 rocketmq-slave2
192.168.1.145 rocketmq-master2
192.168.1.145 rocketmq-slave1
配置完成後, 重啟網絡卡
systemctl restart network
1.3.5 防火牆配置
宿主機需要遠端訪問虛擬機器的rocketmq服務和web服務,需要開放相關的埠號,簡單粗暴的方式是直接關閉防火牆
# 關閉防火牆
systemctl stop firewalld.service
# 檢視防火牆的狀態
firewall-cmd --state
# 禁止firewall開機啟動
systemctl disable firewalld.service
或者為了安全,只開放特定的埠號,RocketMQ預設使用3個埠:9876 、10911 、11011 。如果防火牆沒有關閉的話,那麼防火牆就必須開放這些埠:
nameserver
預設使用 9876 埠master
預設使用 10911 埠slave
預設使用11011 埠
執行以下命令:
# 開放name server預設埠
firewall-cmd --remove-port=9876/tcp --permanent
# 開放master預設埠
firewall-cmd --remove-port=10911/tcp --permanent
# 開放slave預設埠 (當前叢集模式可不開啟)
firewall-cmd --remove-port=11011/tcp --permanent
# 重啟防火牆
firewall-cmd --reload
1.3.6 環境變數配置
vim /etc/profile
在profile檔案的末尾加入如下命令
#set rocketmq
ROCKETMQ_HOME=/root/rocketmq-all-4.4.0-bin-release
PATH=$PATH:$ROCKETMQ_HOME/bin
export ROCKETMQ_HOME PATH
輸入:wq! 儲存並退出, 並使得配置立刻生效:
source /etc/profile
1.3.7 建立訊息儲存路徑
mkdir -p /usr/local/rocketmq/store
mkdir -p /usr/local/rocketmq/store/commitlog
mkdir -p /usr/local/rocketmq/store/consumequeue
mkdir -p /usr/local/rocketmq/store/index
mkdir -p /usr/local/rocketmq/store1
mkdir -p /usr/local/rocketmq/store1/commitlog
mkdir -p /usr/local/rocketmq/store1/consumequeue
mkdir -p /usr/local/rocketmq/store1/index
1.3.8 broker配置檔案
1)master1
伺服器:192.168.1.144
vi /usr/soft/rocketmq/conf/2m-2s-sync/broker-a.properties
修改配置如下:
#所屬叢集名字
brokerClusterName=rocketmq-cluster
#broker名字,注意此處不同的配置檔案填寫的不一樣
brokerName=broker-a
#0 表示 Master,>0 表示 Slave
brokerId=0
#nameServer地址,分號分割
namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
#在傳送訊息時,自動建立伺服器不存在的topic,預設建立的佇列數
defaultTopicQueueNums=4
#是否允許 Broker 自動建立Topic,建議線下開啟,線上關閉
autoCreateTopicEnable=true
#是否允許 Broker 自動建立訂閱組,建議線下開啟,線上關閉
autoCreateSubscriptionGroup=true
#Broker 對外服務的監聽埠
listenPort=10911
#刪除檔案時間點,預設凌晨 4點
deleteWhen=04
#檔案保留時間,預設 48 小時
fileReservedTime=120
#commitLog每個檔案的大小預設1G
mapedFileSizeCommitLog=1073741824
#ConsumeQueue每個檔案預設存30W條,根據業務情況調整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
#檢測物理檔案磁碟空間
diskMaxUsedSpaceRatio=88
#儲存路徑
storePathRootDir=/usr/local/rocketmq/store
#commitLog 儲存路徑
storePathCommitLog=/usr/local/rocketmq/store/commitlog
#消費佇列儲存路徑儲存路徑
storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue
#訊息索引儲存路徑
storePathIndex=/usr/local/rocketmq/store/index
#checkpoint 檔案儲存路徑
storeCheckpoint=/usr/local/rocketmq/store/checkpoint
#abort 檔案儲存路徑
abortFile=/usr/local/rocketmq/store/abort
#限制的訊息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughInterval=10000
#flushConsumeQueueThoroughInterval=60000
#Broker 的角色
#- ASYNC_MASTER 非同步複製Master
#- SYNC_MASTER 同步雙寫Master
#- SLAVE
brokerRole=SYNC_MASTER
#刷盤方式
#- ASYNC_FLUSH 非同步刷盤
#- SYNC_FLUSH 同步刷盤
flushDiskType=SYNC_FLUSH
#checkTransactionMessageEnable=false
#發訊息執行緒池數量
#sendMessageThreadPoolNums=128
#拉訊息執行緒池數量
#pullMessageThreadPoolNums=128
2)slave2
伺服器:192.168.1.144
vi /usr/soft/rocketmq/conf/2m-2s-sync/broker-b-s.properties
修改配置如下:
#所屬叢集名字
brokerClusterName=rocketmq-cluster
#broker名字,注意此處不同的配置檔案填寫的不一樣
brokerName=broker-b
#0 表示 Master,>0 表示 Slave
brokerId=1
#nameServer地址,分號分割
namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
#在傳送訊息時,自動建立伺服器不存在的topic,預設建立的佇列數
defaultTopicQueueNums=4
#是否允許 Broker 自動建立Topic,建議線下開啟,線上關閉
autoCreateTopicEnable=true
#是否允許 Broker 自動建立訂閱組,建議線下開啟,線上關閉
autoCreateSubscriptionGroup=true
#Broker 對外服務的監聽埠
listenPort=11011
#刪除檔案時間點,預設凌晨 4點
deleteWhen=04
#檔案保留時間,預設 48 小時
fileReservedTime=120
#commitLog每個檔案的大小預設1G
mapedFileSizeCommitLog=1073741824
#ConsumeQueue每個檔案預設存30W條,根據業務情況調整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
#檢測物理檔案磁碟空間
diskMaxUsedSpaceRatio=88
#儲存路徑
storePathRootDir=/usr/local/rocketmq/store1
#commitLog 儲存路徑
storePathCommitLog=/usr/local/rocketmq/store1/commitlog
#消費佇列儲存路徑儲存路徑
storePathConsumeQueue=/usr/local/rocketmq/store1/consumequeue
#訊息索引儲存路徑
storePathIndex=/usr/local/rocketmq/store1/index
#checkpoint 檔案儲存路徑
storeCheckpoint=/usr/local/rocketmq/store1/checkpoint
#abort 檔案儲存路徑
abortFile=/usr/local/rocketmq/store1/abort
#限制的訊息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughInterval=10000
#flushConsumeQueueThoroughInterval=60000
#Broker 的角色
#- ASYNC_MASTER 非同步複製Master
#- SYNC_MASTER 同步雙寫Master
#- SLAVE
brokerRole=SLAVE
#刷盤方式
#- ASYNC_FLUSH 非同步刷盤
#- SYNC_FLUSH 同步刷盤
flushDiskType=ASYNC_FLUSH
#checkTransactionMessageEnable=false
#發訊息執行緒池數量
#sendMessageThreadPoolNums=128
#拉訊息執行緒池數量
#pullMessageThreadPoolNums=128
3)master2
伺服器:192.168.1.145
vi /usr/soft/rocketmq/conf/2m-2s-sync/broker-b.properties
修改配置如下:
#所屬叢集名字
brokerClusterName=rocketmq-cluster
#broker名字,注意此處不同的配置檔案填寫的不一樣
brokerName=broker-b
#0 表示 Master,>0 表示 Slave
brokerId=0
#nameServer地址,分號分割
namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
#在傳送訊息時,自動建立伺服器不存在的topic,預設建立的佇列數
defaultTopicQueueNums=4
#是否允許 Broker 自動建立Topic,建議線下開啟,線上關閉
autoCreateTopicEnable=true
#是否允許 Broker 自動建立訂閱組,建議線下開啟,線上關閉
autoCreateSubscriptionGroup=true
#Broker 對外服務的監聽埠
listenPort=10911
#刪除檔案時間點,預設凌晨 4點
deleteWhen=04
#檔案保留時間,預設 48 小時
fileReservedTime=120
#commitLog每個檔案的大小預設1G
mapedFileSizeCommitLog=1073741824
#ConsumeQueue每個檔案預設存30W條,根據業務情況調整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
#檢測物理檔案磁碟空間
diskMaxUsedSpaceRatio=88
#儲存路徑
storePathRootDir=/usr/local/rocketmq/store
#commitLog 儲存路徑
storePathCommitLog=/usr/local/rocketmq/store/commitlog
#消費佇列儲存路徑儲存路徑
storePathConsumeQueue=/usr/local/rocketmq/store/consumequeue
#訊息索引儲存路徑
storePathIndex=/usr/local/rocketmq/store/index
#checkpoint 檔案儲存路徑
storeCheckpoint=/usr/local/rocketmq/store/checkpoint
#abort 檔案儲存路徑
abortFile=/usr/local/rocketmq/store/abort
#限制的訊息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughInterval=10000
#flushConsumeQueueThoroughInterval=60000
#Broker 的角色
#- ASYNC_MASTER 非同步複製Master
#- SYNC_MASTER 同步雙寫Master
#- SLAVE
brokerRole=SYNC_MASTER
#刷盤方式
#- ASYNC_FLUSH 非同步刷盤
#- SYNC_FLUSH 同步刷盤
flushDiskType=SYNC_FLUSH
#checkTransactionMessageEnable=false
#發訊息執行緒池數量
#sendMessageThreadPoolNums=128
#拉訊息執行緒池數量
#pullMessageThreadPoolNums=128
4)slave1
伺服器:192.168.1.145
vi /usr/soft/rocketmq/conf/2m-2s-sync/broker-a-s.properties
修改配置如下:
#所屬叢集名字
brokerClusterName=rocketmq-cluster
#broker名字,注意此處不同的配置檔案填寫的不一樣
brokerName=broker-a
#0 表示 Master,>0 表示 Slave
brokerId=1
#nameServer地址,分號分割
namesrvAddr=rocketmq-nameserver1:9876;rocketmq-nameserver2:9876
#在傳送訊息時,自動建立伺服器不存在的topic,預設建立的佇列數
defaultTopicQueueNums=4
#是否允許 Broker 自動建立Topic,建議線下開啟,線上關閉
autoCreateTopicEnable=true
#是否允許 Broker 自動建立訂閱組,建議線下開啟,線上關閉
autoCreateSubscriptionGroup=true
#Broker 對外服務的監聽埠
listenPort=11011
#刪除檔案時間點,預設凌晨 4點
deleteWhen=04
#檔案保留時間,預設 48 小時
fileReservedTime=120
#commitLog每個檔案的大小預設1G
mapedFileSizeCommitLog=1073741824
#ConsumeQueue每個檔案預設存30W條,根據業務情況調整
mapedFileSizeConsumeQueue=300000
#destroyMapedFileIntervalForcibly=120000
#redeleteHangedFileInterval=120000
#檢測物理檔案磁碟空間
diskMaxUsedSpaceRatio=88
#儲存路徑
storePathRootDir=/usr/local/rocketmq/store1
#commitLog 儲存路徑
storePathCommitLog=/usr/local/rocketmq/store1/commitlog
#消費佇列儲存路徑儲存路徑
storePathConsumeQueue=/usr/local/rocketmq/store1/consumequeue
#訊息索引儲存路徑
storePathIndex=/usr/local/rocketmq/store1/index
#checkpoint 檔案儲存路徑
storeCheckpoint=/usr/local/rocketmq/store1/checkpoint
#abort 檔案儲存路徑
abortFile=/usr/local/rocketmq/store1/abort
#限制的訊息大小
maxMessageSize=65536
#flushCommitLogLeastPages=4
#flushConsumeQueueLeastPages=2
#flushCommitLogThoroughInterval=10000
#flushConsumeQueueThoroughInterval=60000
#Broker 的角色
#- ASYNC_MASTER 非同步複製Master
#- SYNC_MASTER 同步雙寫Master
#- SLAVE
brokerRole=SLAVE
#刷盤方式
#- ASYNC_FLUSH 非同步刷盤
#- SYNC_FLUSH 同步刷盤
flushDiskType=ASYNC_FLUSH
#checkTransactionMessageEnable=false
#發訊息執行緒池數量
#sendMessageThreadPoolNums=128
#拉訊息執行緒池數量
#pullMessageThreadPoolNums=128
1.3.9 修改啟動指令碼檔案
1)runbroker.sh
vi /usr/local/rocketmq/bin/runbroker.sh
需要根據記憶體大小進行適當的對JVM引數進行調整:
#===================================================
# 開發環境配置 JVM Configuration
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m"
2)runserver.sh
vim /usr/local/rocketmq/bin/runserver.sh
JAVA_OPT="${JAVA_OPT} -server -Xms256m -Xmx256m -Xmn128m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"
1.3.10 服務啟動
1)啟動NameServe叢集
分別在192.168.1.144和192.168.1.145啟動NameServer
cd /usr/local/rocketmq/bin
nohup sh mqnamesrv &
2)啟動Broker叢集
- 在192.168.1.144上啟動master1和slave2
master1:
cd /usr/local/rocketmq/bin
nohup sh mqbroker -c /usr/soft/rocketmq/conf/2m-2s-sync/broker-a.properties &
slave2:
cd /usr/local/rocketmq/bin
nohup sh mqbroker -c /usr/soft/rocketmq/conf/2m-2s-sync/broker-b-s.properties &
- 在192.168.1.145上啟動master2和slave2
master2
cd /usr/local/rocketmq/bin
nohup sh mqbroker -c /usr/soft/rocketmq/conf/2m-2s-sync/broker-b.properties &
slave1
cd /usr/local/rocketmq/bin
nohup sh mqbroker -c /usr/soft/rocketmq/conf/2m-2s-sync/broker-a-s.properties &
1.3.11 檢視程序狀態
啟動後通過JPS檢視啟動程序
1.3.12 檢視日誌
# 檢視nameServer日誌
tail -500f ~/logs/rocketmqlogs/namesrv.log
# 檢視broker日誌
tail -500f ~/logs/rocketmqlogs/broker.log
1.4 mqadmin管理工具
1.4.1 使用方式
進入RocketMQ安裝位置,在bin目錄下執行./mqadmin {command} {args}
1.4.2 命令介紹
1)Topic相關
名稱 | 含義 | 命令選項 | 說明 |
updateTopic | 建立更新Topic配置 | -b | Broker 地址,表示 topic 所在 Broker,只支援單臺Broker,地址為ip:port |
-c | cluster 名稱,表示 topic 所在叢集(叢集可通過 clusterList 查詢) | ||
-h- | 列印幫助 | ||
-n | NameServer服務地址,格式 ip:port | ||
-p | 指定新topic的讀寫許可權( W=2|R=4|WR=6 ) | ||
-r | 可讀佇列數(預設為 8) | ||
-w | 可寫佇列數(預設為 8) | ||
-t | topic 名稱(名稱只能使用字元 ^[a-zA-Z0-9_-]+$ ) | ||
deleteTopic | 刪除Topic | -c | cluster 名稱,表示刪除某叢集下的某個 topic (叢集 可通過 clusterList 查詢) |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic 名稱(名稱只能使用字元 ^[a-zA-Z0-9_-]+$ ) | ||
topicList | 檢視 Topic 列表資訊 | -h | 列印幫助 |
-c | 不配置-c只返回topic列表,增加-c返回clusterName, topic, consumerGroup資訊,即topic的所屬叢集和訂閱關係,沒有引數 | ||
-n | NameServer 服務地址,格式 ip:port | ||
topicRoute | 檢視 Topic 路由資訊 | -t | topic 名稱 |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
topicStatus | 檢視 Topic 訊息佇列offset | -t | topic 名稱 |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
topicClusterList | 檢視 Topic 所在叢集列表 | -t | topic 名稱 |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
updateTopicPerm | 更新 Topic 讀寫許可權 | -t | topic 名稱 |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
-b | Broker 地址,表示 topic 所在 Broker,只支援單臺Broker,地址為ip:port | ||
-p | 指定新 topic 的讀寫許可權( W=2|R=4|WR=6 ) | ||
-c | cluster 名稱,表示 topic 所在叢集(叢集可通過 clusterList 查詢),-b優先,如果沒有-b,則對叢集中所有Broker執行命令 | ||
updateOrderConf | 從NameServer上建立、刪除、獲取特定名稱空間的kv配置,目前還未啟用 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic,鍵 | ||
-v | orderConf,值 | ||
-m | method,可選get、put、delete | ||
allocateMQ | 以平均負載演算法計算消費者列表負載訊息佇列的負載結果 | -t | topic 名稱 |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
-i | ipList,用逗號分隔,計算這些ip去負載Topic的訊息佇列 | ||
statsAll | 列印Topic訂閱關係、TPS、積累量、24h讀寫總量等資訊 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-a | 是否只打印活躍topic | ||
-t | 指定topic |
名稱 | 含義 | 命令選項 | 說明 |
clusterList | 檢視叢集資訊,叢集、BrokerName、BrokerId、TPS等資訊 | -m | 列印更多資訊 (增加打印出如下資訊 #InTotalYest, #OutTotalYest, #InTotalToday ,#OutTotalToday) |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
-i | 列印間隔,單位秒 | ||
clusterRT | 傳送訊息檢測叢集各Broker RT。訊息發往${BrokerName} Topic。 | -a | amount,每次探測的總數,RT = 總時間 / amount |
-s | 訊息大小,單位B | ||
-c | 探測哪個叢集 | ||
-p | 是否列印格式化日誌,以|分割,預設不列印 | ||
-h | 列印幫助 | ||
-m | 所屬機房,列印使用 | ||
-i | 傳送間隔,單位秒 | ||
-n | NameServer 服務地址,格式 ip:port |
3)Broker相關
名稱 | 含義 | 命令選項 | 說明 |
updateBrokerConfig | 更新 Broker 配置檔案,會修改Broker.conf | -b | Broker 地址,格式為ip:port |
-c | cluster 名稱 | ||
-k | key 值 | ||
-v | value 值 | ||
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
brokerStatus | 檢視 Broker 統計資訊、執行狀態(你想要的資訊幾乎都在裡面) | -b | Broker 地址,地址為ip:port |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
brokerConsumeStats | Broker中各個消費者的消費情況,按Message Queue維度返回Consume Offset,Broker Offset,Diff,TImestamp等資訊 | -b | Broker 地址,地址為ip:port |
-t | 請求超時時間 | ||
-l | diff閾值,超過閾值才打印 | ||
-o | 是否為順序topic,一般為false | ||
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
getBrokerConfig | 獲取Broker配置 | -b | Broker 地址,地址為ip:port |
-n | NameServer 服務地址,格式 ip:port | ||
wipeWritePerm | 從NameServer上清除 Broker寫許可權 | -b | Broker 地址,地址為ip:port |
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 | ||
cleanExpiredCQ | 清理Broker上過期的Consume Queue,如果手動減少對列數可能產生過期佇列 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-b | Broker 地址,地址為ip:port | ||
-c | 叢集名稱 | ||
cleanUnusedTopic | 清理Broker上不使用的Topic,從記憶體中釋放Topic的Consume Queue,如果手動刪除Topic會產生不使用的Topic | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-b | Broker 地址,地址為ip:port | ||
-c | 叢集名稱 | ||
sendMsgStatus | 向Broker發訊息,返回傳送狀態和RT | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-b | BrokerName,注意不同於Broker地址 | ||
-s | 訊息大小,單位B | ||
-c | 傳送次數 |
名稱 | 含義 | 命令選項 | 說明 |
queryMsgById | 根據offsetMsgId查詢msg,如果使用開源控制檯,應使用offsetMsgId,此命令還有其他引數,具體作用請閱讀QueryMsgByIdSubCommand。 | -i | msgId |
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
queryMsgByKey | 根據訊息 Key 查詢訊息 | -k | msgKey |
-t | Topic 名稱 | ||
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
queryMsgByOffset | 根據 Offset 查詢訊息 | -b | Broker 名稱,(這裡需要注意 填寫的是 Broker 的名稱,不是 Broker 的地址,Broker 名稱可以在 clusterList 查到) |
-i | query 佇列 id | ||
-o | offset 值 | ||
-t | topic 名稱 | ||
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
queryMsgByUniqueKey | 根據msgId查詢,msgId不同於offsetMsgId,區別詳見常見運維問題。-g,-d配合使用,查到訊息後嘗試讓特定的消費者消費訊息並返回消費結果 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-i | uniqe msg id | ||
-g | consumerGroup | ||
-d | clientId | ||
-t | topic名稱 | ||
checkMsgSendRT | 檢測向topic發訊息的RT,功能類似clusterRT | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic名稱 | ||
-a | 探測次數 | ||
-s | 訊息大小 | ||
sendMessage | 傳送一條訊息,可以根據配置發往特定Message Queue,或普通傳送。 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic名稱 | ||
-p | body,訊息體 | ||
-k | keys | ||
-c | tags | ||
-b | BrokerName | ||
-i | queueId | ||
consumeMessage | 消費訊息。可以根據offset、開始&結束時間戳、訊息佇列消費訊息,配置不同執行不同消費邏輯,詳見ConsumeMessageCommand。 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic名稱 | ||
-b | BrokerName | ||
-o | 從offset開始消費 | ||
-i | queueId | ||
-g | 消費者分組 | ||
-s | 開始時間戳,格式詳見-h | ||
-d | 結束時間戳 | ||
-c | 消費多少條訊息 | ||
printMsg | 從Broker消費訊息並列印,可選時間段 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic名稱 | ||
-c | 字符集,例如UTF-8 | ||
-s | subExpress,過濾表示式 | ||
-b | 開始時間戳,格式參見-h | ||
-e | 結束時間戳 | ||
-d | 是否列印訊息體 | ||
printMsgByQueue | 類似printMsg,但指定Message Queue | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-t | topic名稱 | ||
-i | queueId | ||
-a | BrokerName | ||
-c | 字符集,例如UTF-8 | ||
-s | subExpress,過濾表示式 | ||
-b | 開始時間戳,格式參見-h | ||
-e | 結束時間戳 | ||
-p | 是否列印訊息 | ||
-d | 是否列印訊息體 | ||
-f | 是否統計tag數量並列印 | ||
resetOffsetByTime | 按時間戳重置offset,Broker和consumer都會重置 | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-g | 消費者分組 | ||
-t | topic名稱 | ||
-s | 重置為此時間戳對應的offset | ||
-f | 是否強制重置,如果false,只支援回溯offset,如果true,不管時間戳對應offset與consumeOffset關係 | ||
-c | 是否重置c++客戶端offset |
5)消費者、消費組相關
名稱 | 含義 | 命令選項 | 說明 |
consumerProgress | 檢視訂閱組消費狀態,可以檢視具體的client IP的訊息積累量 | -g | 消費者所屬組名 |
-s | 是否列印client IP | ||
-h | 列印幫助 | ||
-n | NameServer 服務地址,格式 ip:port | ||
consumerStatus | 檢視消費者狀態,包括同一個分組中是否都是相同的訂閱,分析Process Queue是否堆積,返回消費者jstack結果,內容較多,使用者參見ConsumerStatusSubCommand | -h | 列印幫助 |
-n | NameServer 服務地址,格式 ip:port | ||
-g | consumer group | ||
-i | clientId | ||
-s | 是否執行jstack | ||
getConsumerStatus | 獲取 Consumer 消費進度 | -g | 消費者所屬組名 |
-t | 查詢主題 | ||
-i | Consumer 客戶端 ip | ||
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 | ||
updateSubGroup | 更新或建立訂閱關係 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-b | Broker地址 | ||
-c | 叢集名稱 | ||
-g | 消費者分組名稱 | ||
-s | 分組是否允許消費 | ||
-m | 是否從最小offset開始消費 | ||
-d | 是否是廣播模式 | ||
-q | 重試佇列數量 | ||
-r | 最大重試次數 | ||
-i | 當slaveReadEnable開啟時有效,且還未達到從slave消費時建議從哪個BrokerId消費,可以配置備機id,主動從備機消費 | ||
-w | 如果Broker建議從slave消費,配置決定從哪個slave消費,配置BrokerId,例如1 | ||
-a | 當消費者數量變化時是否通知其他消費者負載均衡 | ||
deleteSubGroup | 從Broker刪除訂閱關係 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-b | Broker地址 | ||
-c | 叢集名稱 | ||
-g | 消費者分組名稱 | ||
cloneGroupOffset | 在目標群組中使用源群組的offset | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-s | 源消費者組 | ||
-d | 目標消費者組 | ||
-t | topic名稱 | ||
-o | 暫未使用 |
6)連線相關
名稱 | 含義 | 命令選項 | 說明 |
consumerConnec tion | 查詢 Consumer 的網路連線 | -g | 消費者所屬組名 |
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 | ||
producerConnec tion | 查詢 Producer 的網路連線 | -g | 生產者所屬組名 |
-t | 主題名稱 | ||
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 |
7)NameServer相關
名稱 | 含義 | 命令選項 | 說明 |
updateKvConfig | 更新NameServer的kv配置,目前還未使用 | -s | 名稱空間 |
-k | key | ||
-v | value | ||
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 | ||
deleteKvConfig | 刪除NameServer的kv配置 | -s | 名稱空間 |
-k | key | ||
-n | NameServer 服務地址,格式 ip:port | ||
-h | 列印幫助 | ||
getNamesrvConfig | 獲取NameServer配置 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
updateNamesrvConfig | 修改NameServer配置 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 | ||
-k | key | ||
-v | value |
8)其他
名稱 | 含義 | 命令選項 | 說明 |
startMonitoring | 開啟監控程序,監控訊息誤刪、重試佇列訊息數等 | -n | NameServer 服務地址,格式 ip:port |
-h | 列印幫助 |
- 幾乎所有命令都需要配置-n表示NameServer地址,格式為ip:port
- 幾乎所有命令都可以通過-h獲取幫助
- 如果既有Broker地址(-b)配置項又有clusterName(-c)配置項,則優先以Broker地址執行命令;如果不配置Broker地址,則對叢集中所有主機執行命令
1.5 叢集監控平臺搭建
1.5.1 概述
RocketMQ
有一個對其擴充套件的開源專案incubator-rocketmq-externals,這個專案中有一個子模組叫rocketmq-console
,這個便是管理控制檯專案了,先將incubator-rocketmq-externals拉到本地,因為我們需要自己對rocketmq-console
進行編譯打包執行。
1.5.2 下載並編譯打包
git clone https://github.com/apache/rocketmq-externals
cd rocketmq-console
mvn clean package -Dmaven.test.skip=true
注意:打包前在rocketmq-console
中配置namesrv
叢集地址:
rocketmq.config.namesrvAddr=192.168.1.144:9876;192.168.1.145:9876
啟動rocketmq-console:
java -jar rocketmq-console-ng-1.0.0.jar
啟動成功後,我們就可以通過瀏覽器訪問http://192.168.1.144:8080
進入控制檯介面了,如下圖:
叢集狀態: