如《[JMeter 測試元件介紹](https://www.emqx.com/zh/blog/introduction-to-jmeter-test-components)》所述，JMeter 內建 HTTP/HTTPS、TCP 等支援多種協議，還具備外掛擴充套件機制。

MQTT 協議身為物聯網界的主流協議，雖然並非 JMeter 自帶的協議型別，但在物聯網測試場景中極為普遍。為了支援 MQTT 協議的規模測試，EMQ 映雲科技開發了基於 JMeter 的 MQTT 協議開源測試外掛：[https://github.com/xmeter-net/mqtt-jmeter](https://github.com/xmeter-net/mqtt-jmeter) 。

經過幾個版本的迭代，目前 JMeter MQTT 外掛的最新版本為 2.0.2，支援連線、訊息釋出、訊息訂閱等多種取樣器，並可透過組合構建更復雜的測試場景。

本文我們將具體介紹如何在 JMeter 中使用 MQTT 外掛。

## 安裝 MQTT 外掛

MQTT 外掛的安裝方式與其他 JMeter 第三方外掛類似。

1. 從 GitHub 上下載最新版本外掛 [mqtt-xmeter-2.0.2-jar-with-dependencies.jar](https://github.com/xmeter-net/mqtt-jmeter/releases/download/v2.0.2/mqtt-xmeter-2.0.2-jar-with-dependencies.jar)，該外掛支援 JMeter 3.2 及以上版本。
2. 將外掛 jar 包複製到 JMeter 的外掛目錄：`$JMETER_HOME/lib/ext`
3. 重新啟動 JMeter。

## MQTT 外掛中的主要元件

### MQTT 連線取樣器(MQTT Connect)

連線取樣器模擬物聯網裝置，發起 MQTT 連線。

![JMeter MQTT 連線](http://img.blog.itpub.net/blog/2022/02/08/56bd18a475a63ede.png?x-oss-process=style/bb)

**Server name or IP:** 指向被測 MQTT 伺服器地址。

**Port number:** 以 EMQ X 為例，預設 TCP 連線的埠是 1883, SSL 連線則是 8883。具體的埠請參照伺服器的具體配置。

**MQTT version**: 目前支援 MQTT 3.1及3.1.1版本。

**Timeout:** 連線超時設定，以秒為單位。

**Protocols:** 支援TCP、SSL、WS 和 WSS 方式連線 MQTT 伺服器。當選擇 SSL 或 WSS 加密通道連線時，可以選擇單向或者雙向認證(Dual)。如果希望進行雙向認證，還需要指定相應的客戶端證書(p12證書)，以及對應的檔案保護密碼(Secret)。

**User authentication:** 如果 MQTT 伺服器配置了使用者認證，需要提供相應的使用者名稱(**User name**)和密碼(**Password**)。

**ClientId:** 虛擬使用者的標識。如果勾選了「Add random suffix for ClientId」，將會在 ClientId 的基礎上給每個虛擬使用者再新增一個 uuid 串作為字尾，整個作為虛擬使用者標識。

**Keep alive(s):** 心跳訊號傳送間隔。例如，300 表示客戶端每隔 300 秒向伺服器發出 ping 請求，以保持連線活躍。

**Connect attempt max:** 第一次連線過程中，嘗試重連的最大次數。超過該次數則認為連線失敗。如果希望一直嘗試重連，可以設為 -1。

**Reconnect attempt max:** 後繼連線過程中，嘗試重連的最大次數。超過該次數則認為連線失敗。如果希望一直嘗試重連，可以設為 -1。

**Clean session**: 如果希望在連線之間保留會話狀態，可以將該選項設為 false。如果不希望在新的連線中保留會話狀態，則將該項設為true。

### MQTT 訊息釋出取樣器(MQTT Pub Sampler)

訊息釋出取樣器複用連線取樣器中建立的 MQTT 連線，向目標 MQTT 伺服器釋出訊息。

![JMeter 釋出 MQTT 訊息](http://img.blog.itpub.net/blog/2022/02/08/50007e091ae4634d.png?x-oss-process=style/bb)

**QoS Level:** 服務質量，取值為 0，1，2，分別代表 MQTT 協議規範裡的至多一次（AT_MOST_ONCE），至少一次（AT_LEAST_ONCE），精確一次（EXACTLY_ONCE）

**Retained messages**: 如果希望使用[保留訊息](https://www.emqx.com/zh/blog/message-retention-and-message-expiration-interval-of-emqx-mqtt5-broker)，可將該選項設為 true，MQTT 伺服器端將會儲存外掛釋出的保留訊息及其 QoS，並在相應 topic 上發生訂閱時，直接將最後一條保留訊息投遞給訂閱端，使得訂閱端不必等待即可獲取釋出端的最新狀態值。

**Topic name:** 釋出訊息所屬的主題。

**Add timestamp in payload:** 如果勾選，釋出的訊息體開頭會附帶當前時間戳，配合訊息訂閱取樣器的 Payload includes timestamp 選項，可以在訊息接收端計算訊息達到的延時。如果不勾選則只傳送實際的訊息體。

**Payloads** **Message type:** 目前支援三種訊息型別

- String: 普通字串
- Hex String: 以 16 進位制數值表示的串，比如字串 Hello, 可以表示為 48656C6C6F (其中，48在ascii表中對應字母H，依次類推)。通常 16 進位制串用來構造非文字的訊息體，例如描述某些私有的協議互動和控制資訊等等。
- Random string with fixed length: 按指定長度（單位為byte）生成隨機串作為訊息體。

### MQTT 訊息訂閱取樣器(MQTT Sub Sampler)

訊息釋出取樣器複用連線取樣器中建立的 MQTT 連線，從目標 MQTT 伺服器上訂閱訊息。

![JMeter MQTT 訊息訂閱](http://img.blog.itpub.net/blog/2022/02/08/0a72e31e9751daba.png?x-oss-process=style/bb)

**QoS Level:** 服務質量，含義與訊息釋出取樣器相同。

**Topic name(s):** 訂閱訊息所屬的主題。支援單個訊息訂閱取樣器訂閱多個主題，主題之間用逗號分隔。

**Payload includes timestamp:** 如果勾選，會從訊息體開頭處解析傳送時間戳，配合訊息釋出取樣器的 Add timestamp in payload 選項，可以用於計算訊息的接收延時。如果不勾選則只解析實際的訊息體。

**Sample on**: 取樣方式，預設為"**specified elapsed time(ms)**"，即每隔指定的毫秒時間取樣一次。也可以選擇"**number of received messages**"，即每接收到指定的訊息數取樣一次。

**Debug response:** 如果勾選，訊息內容會列印在 JMeter 的響應結果中。該選項主要用於除錯目的，正式執行測試不建議勾選，以免影響測試效率。

### MQTT 斷開連線取樣器(MQTT DisConnect)

斷開連線取樣器中建立的 MQTT 連線。

![JMeter 斷開 MQTT 連線](http://img.blog.itpub.net/blog/2022/02/08/78bc00f39f9deebf.png?x-oss-process=style/bb)

> 為靈活起見，上述取樣器中的屬性值都可以引用 JMeter 的系統或自定義變數。

本文我們介紹了 JMeter MQTT 外掛的各測試元件，在下期文章中我們將針對不同的測試場景詳細介紹如何用 MQTT 外掛來構建測試指令碼。

>版權宣告： 本文為 EMQ 原創，轉載請註明出處。
>
>原文連結：[https://www.emqx.com/zh/blog/how-to-use-the-mqtt-plugin-in-jmeter](https://www.emqx.com/zh/blog/how-to-use-the-mqtt-plugin-in-jmeter)

如何在 JMeter 中使用 MQTT 外掛

相關文章