MQTT JMeter 插件使用教程

MQTT JMeter 插件使用教程

mqtt-jmeter 项目地址: https://gitcode.com/gh_mirrors/mqtt/mqtt-jmeter

1. 项目的目录结构及介绍

mqtt-jmeter/
├── SampleScripts/
│   └── mqtt_jmeter/
├── screenshots/
├── .gitignore
├── LICENSE
├── README.md
└── pom.xml

• SampleScripts/: 包含示例脚本，用于演示如何使用 MQTT JMeter 插件进行测试。
• screenshots/: 包含项目截图，用于文档和演示。
• .gitignore: Git 忽略文件，指定哪些文件和目录不需要被版本控制。
• LICENSE: 项目许可证文件，本项目使用 Apache-2.0 许可证。
• README.md: 项目的自述文件，包含项目的基本介绍、安装和使用说明。
• pom.xml: Maven 项目配置文件，用于构建和管理项目依赖。

2. 项目的启动文件介绍

MQTT JMeter 插件本身是一个 JMeter 插件，因此没有传统意义上的“启动文件”。要使用该插件，您需要按照以下步骤操作：

1. 下载 JMeter: 确保您已经安装了 JMeter（建议版本 3.2 或更高）。
2. 下载插件: 从项目的 GitHub 仓库下载最新版本的 mqtt-jmeter JAR 文件。
3. 安装插件: 将下载的 JAR 文件复制到 $JMETER_HOME/lib/ext 目录下。
4. 启动 JMeter: 重新启动 JMeter，您将在 JMeter 的“Sampler”菜单中看到“MQTT samplers”。

3. 项目的配置文件介绍

MQTT JMeter 插件的配置主要通过 JMeter 的 GUI 界面进行。以下是主要的配置项：

3.1 Connect Sampler

• Server name or IP: MQTT 服务器的地址，可以是 IP 地址或服务器名称。
• Port number: MQTT 服务器的端口号，通常为 1883（TCP）或 8883（SSL）。
• MQTT version: MQTT 协议版本，默认为 3.1，可选 3.1.1。
• Timeout(s): 连接超时时间，默认为 10 秒。
• MQTT Protocol: 支持的协议包括 TCP、SSL、WS、WSS。
• User authentication: 用户认证配置，包括用户名和密码。
• Connection options: 连接选项，如 ClientId、Keep alive 等。

3.2 Pub Sampler

• QoS level: 消息服务质量（QoS），可选 0（最多一次）、1（至少一次）、2（恰好一次）。
• Retained messages: 是否保留消息。
• Topic name: 发布消息的主题名称。
• Payloads: 消息内容，支持字符串、十六进制字符串和随机字符串。

3.3 Sub Sampler

• QoS level: 消息服务质量（QoS），可选 0（最多一次）、1（至少一次）、2（恰好一次）。
• Topic name(s): 订阅的主题名称列表。
• Payload includes timestamp: 是否包含时间戳，用于计算消息延迟。
• Sample on: 采样方式，默认为按时间间隔采样。

3.4 DisConnect Sampler

• DisConnect Sampler: 断开与 MQTT 服务器的连接。

通过以上配置，您可以轻松地在 JMeter 中使用 MQTT JMeter 插件进行 MQTT 协议的性能测试。

mqtt-jmeter 项目地址: https://gitcode.com/gh_mirrors/mqtt/mqtt-jmeter