Bench

Bench 是使用 NanoSDK 编写的简洁强大的 MQTT 协议性能测试工具。

编译

注意： bench 工具默认不构建，您可以通过-DBUILD_BENCH=ON 启用它。

bash

$ mkdir build && cd build
$ cmake -G Ninja -DBUILD_BENCH=ON ..
$ Ninja

编译完成后，会生成一个名为“ nanomq_cli ”的可执行文件。执行以下命令确认可以正常使用：

bash

$ nanomq_cli 
available tools:
   * pub
   * sub
   * conn
   * bench
   * nngproxy
   * nngcat
   * dds

Copyright 2022 EMQ Edge Computing Team

bash

$ nanomq_cli bench
Usage: nanomq_cli bench { pub | sub | conn } [--help]

以上内容的输出证明bench已经被正确编译。

使用

bench 有三个子命令：

pub：用于创建大量客户端来执行发布消息的操作。
sub：用于创建大量客户端订阅主题和接收消息。
conn：用于创建大量连接。

发布

执行 nanomq_cli bench pub --help 时，您将获得可用的参数输出。

Parameter	abbreviation	Optional value	Default value	Description
--host	-h	-	localhost	服务端地址
--port	-p	-	1883	服务端端口
--version	-V	3 4 5	5	MQTT 协议版本
--count	-c	-	200	客户端数量
--interval	-i	-	10	创建客户端的时间间隔 (ms)
--interval_of_msg	-I	-	1000	发布消息时间间隔
--username	-u	-	None; optional	客户端用户名
--password	-P	-	None; optional	客户端密码
--topic	-t	-	None; required	发布主题
--size	-s	-	256	消息负载的大小
--qos	-q	-	0	Qos 服务级别
--retain	-r	true false	false	保留消息标示位
--keepalive	-k	-	300	保活时间
--clean	-C	true false	true	清理会话标示位
--ssl	-S	true false	false	SSL 使能位
--certfile	-	-	None	客户端 SSL 证书
--keyfile	-	-	None	客户端私钥
--ws	-	true false	false	是为建立 websocket 连接

例如，我们启动 10 个连接，每秒向主题 t 发送 100 条 Qos0 消息，其中每个消息负载的大小为 16 字节：

bash

$ nanomq_cli bench pub -t t -h nanomq-server -s 16 -q 0 -c 10 -I 10

连接

执行 nanomq_cli bench conn --help 以获取此子命令的所有可用参数。它们的解释已包含在上表中，此处不再赘述。

例如，我们启动 1000 个连接：

bash

$ nanomq_cli bench conn -h nano-server -c 1000

SSL 连接

bench 支持建立安全的 SSL 连接和执行测试。

单向认证

bash

$ nanomq_cli bench sub -c 100 -i 10 -t bench -p 8883 -S
$ nanomq_cli bench pub -c 100 -I 10 -t bench -p 8883 -s 256 -S

双向认证

bash

$ nanomq_cli bench sub -c 100 -i 10 -t bench -p 8883 --certfile path/to/client-cert.pem --keyfile path/to/client-key.pem
$ nanomq_cli bench pub -c 100 -i 10 -t bench -s 256 -p 8883 --certfile path/to/client-cert.pem --keyfile path/to/client-key.pem

Bench ​

编译 ​

使用 ​

发布 ​

订阅 ​

连接 ​

SSL 连接 ​

Bench

编译

使用

发布

订阅

连接

SSL 连接