Jmeter中mqtt插件使用简介

使用MQTT-JMeter插件，可以方便地添加MQTT连接、发布、订阅取样器，构造组合的应用场景，例如背景连接、多发少收、少发多收，计算消息转发时延等。

下面介绍一下插件的使用方法。

安装

从github下载您需要的release版本, 解压mqtt–xmeter-jar-with-dependencies.jar.zip, 将生成的jar文件放到JMeter安装主目录的lib/ext下，重启JMeter，在取样器中就可以看到插件成功加载。

【注】推荐在最新的JMeter5.4.1版本中安装使用本插件。

连接操作取样器

Server name or IP: 指向被测MQTT服务器地址。【注】为灵活起见，属性值都可以引用JMeter的系统或自定义变量。
Port number: 通常TCP连接的端口时1883, SSL连接则是8883。请参照服务器的具体配置。
Timeout(s): 连接超时设置，以秒为单位。
Protocols: 客户端与服务器通过SSL加密通道连接时，可以选择单向或者双向认证(Dual)。双向认证时，您还需要指定相应的信任秘钥库(Trust Key Store), 客户端证书，以及对应的文件保护密码(Secret)。这些文件可以通过服务器的证书配置转化得到。例如，对于EMQ的安装部署，<emqttd_home>/etc/cert下就存放了自签证的CA，服务器及客户端证书，参考下面的命令就可以生成插件所需的.jks, .p12文件，secret自行指定即可。

export PATH=$PATH:<JDK_HOME>/bin

keytool -import -alias cacert -keystore emqtt.jks -file cacert.pem -storepass <Your_Secret> -trustcacerts -noprompt

keytool -import -alias client -keystore emqtt.jks -file client-cert.pem -storepass <Your_Secret>

keytool -import -alias server -keystore emqtt.jks -file cert.pem -storepass <Your_Secret>

openssl pkcs12 -export -inkey client-key.pem -in client-cert.pem -out client.p12 -password pass:<Your_Secret>

User authentication: 如果服务器配置了用户认证，您需要提供相应的用户名和口令。
ClientId prefix: 标识客户端的固定前缀，每个连接(虚拟用户)再添加一个uuid串，整个作为客户标识。
Keep alive(s): 心跳信号发送间隔。例如，300表示客户端每隔300秒向服务器发出ping请求，以保持连接活跃。
Connect attempt max: 第一次连接过程中，尝试重连的最大次数。超过该次数则认为连接失败。
Reconnect attempt max: 后继连接过程中，尝试重连的最大次数。超过该次数则认为连接失败。
Clean session: 设置为0，表示创建一个持久会话，在客户端断开连接时，会话仍然保持并保存离线消息，直到会话超时注销。
设置为1，表示创建一个新的临时会话，在客户端断开时，会话自动销毁。

发布操作取样器

发布(Pub)取样器的连接相关属性与连接取样器完全相同，下面只介绍Pub特有的属性。

Pub options: 服务质量，取值为0，1，2，分别代表MQTT协议规范里的至多一次（AT_MOST_ONCE），至少一次（AT_LEAST_ONCE），精确一次（EXACTLY_ONCE）
Topic name: 发布消息所属的话题（订阅方可以根据话题不同选择订阅）
Add timestamp in payload:如果勾选，发布的消息体开头会附带当前时间戳，利用它可以在消息接收端计算消息达到的延时。不勾选则只发送实际的消息体。
Retained message: 该值为TRUE表示保留消息，保留的消息会驻留在消息服务器，后来的订阅者订阅主题时仍可以接收该消息；该值为false表示不保留消息，当payload为空且该值是true，则会删除这条持久化的消息，如果当payload为空且该值是false，则不会删除这条持久化的消息。
Payloads: 目前支持三种消息类
- String: 普通字符串（如上面截图所示）
- Hex String: 以16进制数值表示的串，比如字符串Hello, 可以表示为48656C6C6F (其中，48在ascii表中对应字母H，依次类推)。通常16进制串用来构造非文本的消息体，例如描述某些私有的协议交互和控制信息等等。
- Random string with fixed length: 按指定长度生成随机的串作为消息体。

订阅操作取样器

Sub options: 服务质量，含义与发布操作取样器相同。
Topic name: 订阅消息所属的话题。
Payload includes timestamp: 如果勾选，会从消息体开头处解析发送时间戳，用于计算消息的接收延时。
Debug response: 如果勾选，消息内容会打印在JMeter的响应结果中，用于调试目的。正式运行测试建议不勾选。
Sample on：采样方式，它控制如何采样。默认值为“elapsed with specified time(ms)”，这意味着子采样器将每指定毫秒发生一次(默认值为1000ms)。在1000 ms期间，可以接收多条消息，结果生成报告是1000 ms期间的摘要数据。如果该值设置为2000，则表示2000 ms期间的摘要报告。另一个选项是“number of received messages”，这意味着子采样器将在接收到这些指定数量的消息后发生(默认值为1)。