How pablitovicente/mqtt-load-generator works
MQTT Load Generator is a Go command-line tool for publishing load, counting subscriptions, and printing received payloads. The main workflow runs through pub (also the default command): validate settings, connect all clients, publish messages, track acknowledgements and latency, then report results. The sub and dump commands provide separate receive-side workflows. The graph includes progress/reporting and broker access; some subsystem links are based on README descriptions because their implementation excerpts were not provided.
Main entry points: cli CLI commands · paho.go MQTT client adapter · publish.go Publish workload · subscribe.go Count messages
Components 20
Command interface
- Signal-aware entry
cmd/main.go - CLI commands
internal/cli - Connection setup
internal/cli/broker.go
MQTT workloads
- Publish workload
internal/mqttload/publish.go - Client coordination
internal/mqttload/connect.go - Count messages
internal/mqttload/subscribe.go - Print payloads
internal/mqttload/dump.go - Payload generation
internal/mqttload/payload.go - Publish statistics
internal/mqttload/publish_stats.go - Subscribe statistics
internal/mqttload/subscribe_stats.go
Broker access
- MQTT client adapter
internal/broker/paho.go - TLS configuration
internal/broker/tls.go - MQTT broker
Progress and reports
- Progress tracking
internal/mqttload/publish_progress.go - Progress display
internal/display/publish.go - Subscribe display
internal/display/subscribe.go - Payload formatting
internal/display/dump.go - Run reports
internal/mqttload/publish_report.go - Subscribe report
internal/mqttload/subscribe_report.go
Other components
- Operator
Connections 25
- Operator → Signal-aware entry: runs
README.md - Signal-aware entry → CLI commands: executes
cmd/main.go - CLI commands → Connection setup: configures
internal/cli/publish.go - CLI commands → Client coordination: starts clients
internal/cli/publish.go - CLI commands → Publish workload: runs workload
internal/cli/publish.go - Client coordination → MQTT client adapter: connects clients
internal/mqttload/connect.go - Connection setup → MQTT client adapter: dials
internal/cli/broker.go - MQTT client adapter → MQTT broker: exchanges MQTT
README.md - MQTT client adapter → TLS configuration: uses TLS
- Publish workload → Payload generation: generates payloads
- Publish workload → Publish statistics: records outcomes
- Publish workload → MQTT client adapter: publishes messages
internal/mqttload/publish.go - Publish workload → Progress tracking: updates progress
- CLI commands → Count messages: runs sub
internal/cli/subscribe.go - CLI commands → Print payloads: runs dump
internal/cli/dump.go - Count messages → MQTT client adapter: subscribes
internal/mqttload/subscribe.go - Print payloads → MQTT client adapter: subscribes
README.md - Count messages → Subscribe statistics: records arrivals
internal/mqttload/subscribe.go - CLI commands → Progress display: starts display
internal/cli/publish.go - CLI commands → Subscribe display: starts display
internal/cli/subscribe.go - CLI commands → Payload formatting: formats messages
internal/cli/dump.go - Progress display → Progress tracking: reads progress
internal/display/publish.go - CLI commands → Run reports: writes report
README.md - CLI commands → Subscribe report: writes report
internal/cli/subscribe.go - Subscribe display → Subscribe statistics: shows counts
internal/display/subscribe.go