How codexdhruv11/lockstep works
Lockstep is a Java load-testing CLI that runs HTTP, database, and Redis workloads against one shared clock, then analyzes and reports aligned latency buckets. The main workflow is CLI configuration → coordinated runners → bucketed measurements → analysis and report/export. Separate commands survey existing targets, search for capacity, estimate growth, and compare saved runs. The README documents optional metrics, tracing, and OTLP capabilities; source excerpts are partial, so some subsystem links are documented rather than verified in implementation.
Main entry points: RunCommand.java CLI commands · RunCoordinator.java Run coordinator · PacedLoop.java Paced execution · HttpRunner.java HTTP runner
Components 24
CLI and configuration
- CLI commands
src/main/java/com/lockstep/cli/RunCommand.java - Run configuration
src/main/java/com/lockstep/config/Config.java
Load execution
- Run coordinator
src/main/java/com/lockstep/core/RunCoordinator.java - Shared run clock
src/main/java/com/lockstep/core/RunContext.java - Paced execution
src/main/java/com/lockstep/core/PacedLoop.java - HTTP runner
src/main/java/com/lockstep/runner/http/HttpRunner.java - Scenario runner
src/main/java/com/lockstep/scenario/ScenarioRunner.java - Database runner
src/main/java/com/lockstep/runner/db/DbRunner.java - Redis runner
src/main/java/com/lockstep/runner/redis/RedisRunner.java - Bucket histograms
src/main/java/com/lockstep/stats/HistogramRecorder.java
Analysis workflows
- Capacity search
src/main/java/com/lockstep/analysis/CapacityFinder.java - Spike correlation
src/main/java/com/lockstep/analysis/SpikeCorrelator.java - Target survey
src/main/java/com/lockstep/analysis/Survey.java - Growth curve
src/main/java/com/lockstep/analysis/GrowthCurve.java
Observability integrations
- Target metrics
src/main/java/com/lockstep/runner/MetricsObserver.java - Trace retrieval
src/main/java/com/lockstep/runner/TraceFetcher.java - OTLP export
src/main/java/com/lockstep/runner/OtlpExporter.java
Reports and comparison
- Run report
src/main/java/com/lockstep/report/RunReport.java - CLI summaries
src/main/java/com/lockstep/report/CliTables.java - Run comparison
src/main/java/com/lockstep/compare/RunComparator.java
Other components
- Operator
- HTTP, DB, Redis targets
- OTLP collector
- Trace backend
Connections 30
- Operator → CLI commands: invokes
README.md - CLI commands → Run configuration: loads
src/main/java/com/lockstep/cli/RunCommand.java - CLI commands → Run coordinator: starts run
src/main/java/com/lockstep/cli/RunCommand.java - Run coordinator → HTTP runner: builds runner
src/main/java/com/lockstep/core/RunCoordinator.java - Run coordinator → Scenario runner: builds runner
src/main/java/com/lockstep/core/RunCoordinator.java - Run coordinator → Database runner: builds runner
src/main/java/com/lockstep/core/RunCoordinator.java - Run coordinator → Redis runner: builds runner
src/main/java/com/lockstep/core/RunCoordinator.java - Run coordinator → Shared run clock: sets shared clock
src/main/java/com/lockstep/core/RunCoordinator.java - HTTP runner → Paced execution: runs workload
src/main/java/com/lockstep/runner/http/HttpRunner.java - Scenario runner → Paced execution: runs workload
src/main/java/com/lockstep/scenario/ScenarioRunner.java - Redis runner → Paced execution: runs workload
src/main/java/com/lockstep/runner/redis/RedisRunner.java - Database runner → Paced execution: runs workload
- Paced execution → Bucket histograms: records latencies
src/main/java/com/lockstep/core/PacedLoop.java - HTTP runner → HTTP, DB, Redis targets: sends requests
README.md - Database runner → HTTP, DB, Redis targets: executes queries
README.md - Redis runner → HTTP, DB, Redis targets: sends commands
README.md - CLI commands → Capacity search: searches capacity
src/main/java/com/lockstep/cli/RunCommand.java - CLI commands → Spike correlation: analyzes spikes
src/main/java/com/lockstep/cli/RunCommand.java - Operator → Target survey: requests survey
README.md - Operator → Growth curve: runs growth test
README.md - Operator → Run comparison: compares runs
README.md - CLI commands → Target metrics: configures metrics
src/main/java/com/lockstep/cli/RunCommand.java - CLI commands → Trace retrieval: configures traces
src/main/java/com/lockstep/cli/RunCommand.java - CLI commands → OTLP export: configures export
src/main/java/com/lockstep/cli/RunCommand.java - Target metrics → HTTP, DB, Redis targets: scrapes metrics
README.md - Trace retrieval → Trace backend: fetches spans
README.md - OTLP export → OTLP collector: exports results
README.md - CLI commands → Run report: builds report
src/main/java/com/lockstep/cli/RunCommand.java - CLI commands → CLI summaries: prints summaries
src/main/java/com/lockstep/cli/RunCommand.java - Run report → Run comparison: compares saved data
src/main/java/com/lockstep/compare/RunComparator.java