emqx/emqtt-bench
55.4
Weak · 13 November 2026
1.9k
lines of production code
Erlang
primary language
8
measurements over time
What this system is
This system is a lightweight benchmarking tool for MQTT v5.0, implemented in Erlang, designed to measure connection, publish, and subscribe performance. It provides configurable logging backends and exposes Prometheus-compatible metrics via a REST API for monitoring. The tool also includes automation scripts for building, signing, and notarizing macOS releases.
Features
Add EMQTT logger backend with console and null options
Users can now configure the EMQTT library's logging behavior through a new \emqtt\_logger\ module. This change introduces a pluggable logging backend system that supports two modes: \console\ for standard output logging and \null\ to suppress all logging output. The \emqtt\_logger\_console\ module handles console-based logging, while \emqtt\_logger\_null\ implements a no-op logger that redirects IO requests to prevent console spam. This allows users to control log verbosity and output destination via the \log\_to\ option in the setup configuration.
src/logger · medium confidence
Add Prometheus metrics endpoint for monitoring
The benchmark tool now exposes a REST API endpoint to serve Prometheus-compatible metrics. This is enabled via the new \--restapi\ option, which can be set to an IP:Port or just a Port to listen on all interfaces. The HTTP server, implemented in \emqtt\_bench\_http\_metrics.erl\, handles GET requests and returns the current Prometheus text format output, allowing users to scrape performance and QoE data directly from the benchmark process.
src · high confidence
Added emqtt\_bench benchmarking tool
A new executable script named emqtt\_bench has been added to the bin directory. This script serves as a launcher for the emqtt\_bench escript, automatically resolving the Erlang runtime path and executing the benchmarking tool with any provided arguments.
bin · high confidence
Added macOS signing and notarization automation for EMQX Bench
New shell scripts in the scripts/ directory automate the macOS build pipeline. ensure-rebar3.sh manages rebar3 versions for OTP 25–28. macos-sign-binaries.sh handles code-signing of runtime libraries and binaries using Apple developer certificates. macos-notarize-package.sh automates the Apple notary submission process. rename-package.sh generates platform-specific package names for Linux and macOS. These scripts enable automated, signed, and notarized macOS releases.
scripts · high confidence
Initial release of emqtt-bench benchmark tool
The emqtt-bench tool is introduced as a lightweight MQTT v5.0 benchmark utility written in Erlang. This initial release provides commands for connection, publish, and subscribe benchmarks, supporting features such as TLS/SSL, QUIC transport, and Prometheus metrics. The tool includes a \topic\_spec.json\ configuration file for defining publisher topics and requires Erlang/OTP 27.2+ to build.
(repo-wide) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 56 → 55 (-0.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.3) — scores are not directly comparable.
Lenses
- Code Health 97 → 96 (-0.9)
- Architecture 99 → 99 (+0.0)
- Maturity 54 → 50 (-3.2)
- Readiness 42 → 42 (+0.0)
- Security 72 → 72 (+0.0)
Resolved (2)
- No ADRs found
- No tests found
New (1)
- No ADRs found (rebar.config)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
emqx/emqtt-bench was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 13 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit cb86b18848da17cae1024e1d06f7e43f8f6691a1 — the exact code this score is about.
- Scored under rubric-2026.11.3 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.61+preprod-b8b1a43ae4c3.