JMX导入MeterSphere注意事项

目录

1 JMX导入性能测试

1.1 JMX中使用了文件

1.2 JMX前后置脚本中引用了外部jar包

1.3 JMX中使用了第三方插件

2 JMX导入接口自动化

2.1 JMX中使用CSV文件参数化

2.2 JMX前后置脚本中引用了外部jar包

2.3 JMX中接口上传了文件

2.4 JMX前后置脚本中使用了文件

2.5 JMX中使用了第三方插件

---

1 JMX导入性能测试

1.1 JMX中使用了文件

性能测试中使用的文件最终都会同步到JMeter容器中的/test目录下，所以在性能测试中上传JMX时，需要将JMX中的文件路径改成/test/文件名的格式，并且将用到的文件在“性能测试-资源文件”中上传。

以下是资源文件在JMeter容器中位置的示例图。

示例：

在JMX中使用了CSV参数化文件，在导入MeterSphere性能测试前，需要将JMX中CSV文件路径修改为/test/user.csv，同时在CSV文件中设置列名，列名跟在JMX中CSV变量名称保持一致，因为在MeterSphere中引用CSV文件时，是直接将CSV文件的列名做为变量名，并且在性能测试中上传user.csv文件。

1.2 JMX前后置脚本中引用了外部jar包

JMX脚本中引用了外部jar包，在上传到性能测试时，需要将jar包上传到性能测试的资源文件中。这样才会把jar包同步到JMeter容器内。

示例：

1.3 JMX中使用了第三方插件

一般JMeter自带的组件，MeterSphere都可以支持。JMeter的拓展插件，比如MQTT取样器、WebSocket取样器等，直接上传到MeterSphere是不支持的，需要对JMeter插件根据MeterSphere官网规范进行改造。目前MeterSphere企业版已改造的的插件包括MQTT、WebSocket、GRPC协议插件等。

例如，如果在JMeter中使用了原生的MQTT取样器，需要将JMX导入接口自动化场景，将原生的MQTT请求替换成适配MeterSphere的MQTT插件，调试成功后再一键转成性能测试，并且将插件jar包上传到性能测试资源文件中。

如果需要相关的插件，请联系飞致云技术人员。上传和使用MeterSphere企业版插件的方法如下：

2 JMX导入接口自动化

2.1 JMX中使用CSV文件参数化

接口自动化的场景变量和环境变量中支持CSV参数化设置。以场景变量为例，JMX文件导入接口自动化后，只需要将自带的CSV 组件删除，然后将CSV文件上传到场景变量，并且设置好列名，列名跟脚本中引用的CSV变量名保持一致，因为在MeterSphere中，CSV文件的列名就是引用时的变量名称。

示例：

2.2 JMX前后置脚本中引用了外部jar包

JMX前后置脚本中使用了外部jar包，导入接口自动化后，需要在“项目设置-文件管理”中上传jar包，并开启“加载jar包”。

示例：

2.3 JMX中接口上传了文件

JMX中有文件上传的接口，导入MeterSphere接口自动化后，需要删除原来的文件，在请求体中重新上传文件。

示例：

2.4 JMX前后置脚本中使用了文件

MeterSphere文件默认存储位置是/opt/metersphere/data/中，如果脚本中需要用到文件，建议手动上传到MeterSphere服务器存储目录下。

2.5 JMX中使用了第三方插件

一般JMeter自带的组件，MeterSphere都可以支持。JMeter的拓展插件，比如MQTT取样器、WebSocket取样器等，直接上传到MeterSphere是不支持的，需要对JMeter插件根据MeterSphere官网规范进行改造。目前MeterSphere企业版已改造的的插件包括MQTT、WebSocket、GRPC协议插件等。

例如，如果在JMeter中使用了原生的MQTT取样器，需要将JMX导入接口自动化场景，将原生的MQTT请求替换成适配MeterSphere的MQTT插件。

如果需要相关的插件，请联系飞致云技术人员。上传和MeterSphere企业版插件的方法如下：