JMeter InfluxDB 后端监听器 全参数详解
2026/4/25 6:57:41 网站建设 项目流程

一、顶部全局配置项

1. 名称

当前这个后端监听器组件的自定义名字,仅 JMeter 内部标识用,不影响数据上报,你填后端监听器只是备注区分。

2. 注释

自定义备注栏,写测试用途、项目信息,无运行效果。

3. 后端监听器实现

org.apache.jmeter.visualizers.backend.influxdb.InfluxdbBackendListenerClient

含义:JMeter 官方内置的、对接InfluxDB 时序数据库的后端监听器核心实现类。作用:定义当前监听器用什么逻辑、协议把压测指标推送到 InfluxDB,你这个是原生 InfluxDB 专属实现,适配 InfluxDB 1.x 版本。

4. 异步队列大小5000

含义:JMeter 内存里,存放待上报 InfluxDB 的压测指标数据的异步缓冲区队列长度。

  • JMeter 压测产生指标速度极快,不会每一条结果实时网络上报(会严重拖慢压测性能),会先全部塞进这个内存队列,后台线程异步批量发送到 InfluxDB。
  • 你当前值5000:队列最多缓存 5000 条待上报数据。
  • 补充:高并发大压测建议适当调大(如 10000);队列满了会阻塞采样器、丢数据,过小会频繁上报增加 IO 开销。

二、下方表格内 所有参数逐行详解

1.influxdbMetricsSender

org.apache.jmeter.visualizers.backend.influxdb.HttpMetricsSender含义:指标发送器实现类。指定用HTTP 协议把压测数据 POST 上报到 InfluxDB 的/write接口,是 InfluxDB 1.x 通用的上报方式,适配你下面配置的 http 格式地址。

2.influxdbUrl

http://192.168.0.11:8086/write?db=jmeter含义:InfluxDB 服务的上报接口完整地址,压测数据的推送目的地。拆解每一段:

  • 192.168.0.11:8086:你部署 InfluxDB 服务的服务器 IP、默认端口 8086
  • /write:InfluxDB 原生写入数据的专属接口
  • ?db=jmeter:URL 参数,指定数据存入 InfluxDB 里名字为jmeter的数据库(需要你提前在 InfluxDB 里手动创建好jmeter这个库,否则上报失败)

3.application

dingcan含义:业务项目标签(应用标识)。会作为 InfluxDB 数据里的tag标签字段,用来区分不同业务、不同项目的压测数据。你这里dingcan就是你的被测项目名,后续 Grafana 看板、数据库查询时,可以用这个标签过滤只看当前项目的压测指标。

4.measurement

jmeter含义:InfluxDB 里的度量表名(时序数据表名)。InfluxDB 存储结构:数据库(database) -> 度量表(measurement) -> 时间线+指标字段。所有 JMeter 压测的聚合指标,都会统一存入这个名为jmeter的 measurement 表中。

5.summaryOnly

true含义:上报粒度开关,核心性能参数!

  • true只上报聚合汇总指标(全线程整体的平均响应时间、吞吐量、错误率、百分位耗时等全局统计数据),不上报每一条接口请求的明细数据。✅ 你的场景最优配置:压测性能开销极小、InfluxDB 存储压力极低,是长稳压测、高并发压测的标准配置。
  • false:每一个请求、每一条采样结果全量明细上报,数据量爆炸大,严重拖慢 JMeter 压测性能,数据库存储占用极高,大并发压测绝对不要开 false

6.samplersRegex

.*含义:采样器过滤正则表达式,控制哪些接口的结果需要上报

  • .*:正则万能匹配,匹配本次压测计划里所有的接口采样器,所有接口数据全部上报。
  • 拓展用法:比如你只想上报登录、下单接口,可以写登录接口|下单接口;不想上报某几个接口就写反向排除正则。

7.percentiles

90;95;99含义:需要统计上报的响应时间百分位指标,分号分隔多个数值。压测行业核心 SLA 指标,会单独计算并上报:

  • 90:P90 响应时间:90% 的请求耗时低于该数值
  • 95:P95 响应时间:95% 的请求耗时低于该数值
  • 99:P99 响应时间:99% 的请求耗时低于该数值这三个是后端压测必看指标,用来评估接口慢请求、长尾耗时情况,也是接口性能验收的核心标准。

8.testTitle

Test name含义:本次压测任务的标题标签。会作为数据 tag 存入 InfluxDB,用来区分同项目、同库下的不同轮次压测。建议你改成有意义的名字,比如订餐项目1000并发长稳压测_20260424,方便后续看板回溯、对比历史压测数据。

9.eventTags

:(空)含义:自定义额外事件标签,预留扩展字段。你可以手动追加自定义 tag,格式key=value,key2=value2,用来补充更多维度筛选信息。举个例子:你可以填env=预发环境,version=v1.2.0,给本次压测打上环境、版本标签,后续 Grafana 可以按环境 / 版本筛选数据。当前为空,代表不追加额外自定义标签。


三、额外补充整体链路 & 踩坑总结

  1. 整套链路JMeter 压测运行 → 后端监听器采集指标 → 异步队列缓存 → Http 发送器上报 → InfluxDB 的jmeterjmeter表存储 → Grafana 对接 InfluxDB 可视化看板画图
  2. 你当前配置的优点summaryOnly=true聚合上报、全接口匹配、行业标准 3 个百分位、项目标签齐全,是生产级高并发压测的标准安全配置,对 JMeter 本机性能损耗最小。
  3. 必做前置检查必须提前在192.168.0.11服务器的 InfluxDB 里,执行命令创建数据库:

    sql

    CREATE DATABASE jmeter
    不创建库会直接上报失败,监听器无数据写入。
  4. 版本适配提醒这套配置仅适配 InfluxDB 1.x,InfluxDB 2.x 接口、鉴权、协议完全变更,这个原生监听器无法直接使用,需要换适配类和 URL 格式。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询