containersol/locust_exporter

Locust Exporter

镜像概述和主要用途

Locust Exporter是一个Prometheus exporter，用于从Locust性能测试工具获取数据并将其导出为Prometheus可抓取的指标。该exporter的设计灵感来源于mbolek/locust_exporter，旨在帮助用户通过Prometheus监控Locust性能测试的运行状态和结果。

核心功能和特性

• 从Locust主节点（Master）获取性能测试数据
• 将Locust指标转换为Prometheus兼容格式
• 可配置的连接参数（如Locust地址、超时时间等）
• 可自定义的Web监听地址和指标暴露路径
• 支持日志级别和格式配置

使用场景和适用范围

适用于使用Locust进行性能测试，并需要通过Prometheus+Grafana等监控系统对测试过程和结果进行实时监控、分析和告警的场景。尤其适合开发、测试环境中的性能测试监控，以及持续集成/持续部署（CI/CD）流程中的性能测试环节。

详细使用方法和配置说明

快速开始

该镜像可通过Docker直接运行，使用前需确保Locust主节点已启动：

1. 启动Locust主节点

2. 启动Locust Exporter

bash
docker run --net=host containersol/locust_exporter

运行配置

命令行标志（Flags）

• locust.uri
  Locust主节点的地址。默认值：http://localhost:8089。

• locust.timeout
  连接Locust的超时时间。默认值：5s。

• web.listen-address
  Exporter的Web接口和遥测数据监听地址。默认值：:9646。

• web.telemetry-path
  暴露指标的路径。默认值：/metrics。

• log.level
  设置日志级别，可选值：debug、info、warn、error、fatal。

• log.format
  设置日志输出目标和格式。例如：logger:syslog?appname=bob&local=7 或 logger:stdout?json=true。默认值：logger:stderr。

环境变量

以下环境变量可用于配置exporter，优先级低于命令行标志：

• LOCUST_EXPORTER_URI
  Locust主节点的地址。默认值：http://localhost:8089。

• LOCUST_EXPORTER_TIMEOUT
  连接Locust的超时时间。默认值：5s。

• LOCUST_EXPORTER_WEB_LISTEN_ADDRESS
  Exporter的Web接口和遥测数据监听地址。默认值：:9646。

• LOCUST_EXPORTER_WEB_TELEMETRY_PATH
  暴露指标的路径。默认值：/metrics。