Documentation / Load Simulation

Load Simulation

Select and compose load models to represent your target traffic pattern.

Time-Based Simulations

Inject(rate, interval, during), InjectRandom(minRate, maxRate, interval, during), RampingInject(rate, interval, during), KeepConstant(copies, during), RampingConstant(copies, during), and Pause(during) are duration-driven models.

Iteration-Based Simulations

IterationsForInject(rate, interval, iterations) and IterationsForConstant(copies, iterations) run for a fixed iteration count instead of a fixed duration.

Parameter Fields

rate/minRate/maxRate define request emission intensity, copies defines concurrent virtual users, interval controls pacing, during controls time window, and iterations controls total execution cycles. Helper APIs also expose IsInject/IsInjectRandom/IsIterationsForInject/IsIterationsForConstant and related flags plus string formatting helpers on returned simulation definitions.

Composition

Attach multiple simulations in sequence using WithLoadSimulations to model warm-up, ramp-up, steady-state, and cooldown phases in one scenario definition.

scenario = scenario.WithLoadSimulations(
    LoadStrikeSimulation.Inject(10, TimeSpan.FromSeconds(1), TimeSpan.FromSeconds(20)),
    LoadStrikeSimulation.RampingInject(20, TimeSpan.FromSeconds(1), TimeSpan.FromSeconds(20)),
    LoadStrikeSimulation.KeepConstant(5, TimeSpan.FromSeconds(20)),
    LoadStrikeSimulation.Pause(TimeSpan.FromSeconds(3))
);

scenario = scenario.withLoadSimulations(
    LoadStrikeSimulation.inject(10, 1d, 20d),
    LoadStrikeSimulation.rampingInject(20, 1d, 20d),
    LoadStrikeSimulation.keepConstant(5, 20d),
    LoadStrikeSimulation.pause(3d)
);

scenario = scenario.with_load_simulations(
    LoadStrikeSimulation.inject(10, 1, 20),
    LoadStrikeSimulation.ramping_inject(20, 1, 20),
    LoadStrikeSimulation.keep_constant(5, 20),
    LoadStrikeSimulation.pause(3),
)

scenario = scenario.withLoadSimulations(
  LoadStrikeSimulation.inject(10, 1, 20),
  LoadStrikeSimulation.rampingInject(20, 1, 20),
  LoadStrikeSimulation.keepConstant(5, 20),
  LoadStrikeSimulation.pause(3)
);

scenario = scenario.withLoadSimulations(
  LoadStrikeSimulation.inject(10, 1, 20),
  LoadStrikeSimulation.rampingInject(20, 1, 20),
  LoadStrikeSimulation.keepConstant(5, 20),
  LoadStrikeSimulation.pause(3)
);