1.1.1.1.1.2. yardstick.benchmark.runners package

1.1.1.1.1.2.1. Submodules

1.1.1.1.1.2.2. yardstick.benchmark.runners.arithmetic module

A runner that every run arithmetically steps specified input value(s) to the scenario. This just means step value(s) is added to the previous value(s). It is possible to combine several named input values and run with those either as nested for loops or combine each i:th index of each “input value list” until the end of the shortest list is reached (optimally all lists should be defined with the same number of values when using such iter_type).

class yardstick.benchmark.runners.arithmetic.ArithmeticRunner(config, queue)[source]

Bases: yardstick.benchmark.runners.base.Runner

Run a scenario arithmetically stepping input value(s)

Parameters:
  • - time to wait between each scenario invocation (interval) – type: int unit: seconds default: 1 sec
  • iter_type
    • Iteration type of input parameter: nested_for_loops
      or tuple_loops

    type: string unit: na default: nested_for_loops

  • -
    name - name of scenario option that will be increased for each invocation
    type: string unit: na default: na
    start - value to use in first invocation of scenario
    type: int unit: na default: none
    stop - value indicating end of invocation. Can be set to same
    value as start for one single value.

    type: int unit: na default: none

    step - value added to start value in next invocation of scenario.
    Must not be set to zero. Can be set negative if start > stop

    type: int unit: na default: none

  • - – name - and so on......

1.1.1.1.1.2.3. yardstick.benchmark.runners.base module

class yardstick.benchmark.runners.base.Runner(config, queue)[source]

Bases: object

abort()[source]

Abort the execution of a scenario

dump_process = None
static get(config)[source]

Returns instance of a scenario runner for execution type.

static get_cls(runner_type)[source]

return class of specified type

static get_types()[source]

return a list of known runner type (class) names

join(timeout=None)[source]
queue = None
static release(runner)[source]

Release the runner

static release_dump_process()[source]

Release the dumper process

run(scenario_cfg, context_cfg)[source]
run_post_stop_action()[source]

run a potentially configured post-stop action

runners = []
static terminate(runner)[source]

Terminate the runner

static terminate_all()[source]

Terminate all runners (subprocesses)

1.1.1.1.1.2.4. yardstick.benchmark.runners.duration module

A runner that runs a specific time before it returns

class yardstick.benchmark.runners.duration.DurationRunner(config, queue)[source]

Bases: yardstick.benchmark.runners.base.Runner

Run a scenario for a certain amount of time

If the scenario ends before the time has elapsed, it will be started again.

Parameters
duration - amount of time the scenario will be run for
type: int unit: seconds default: 1 sec
interval - time to wait between each scenario invocation
type: int unit: seconds default: 1 sec

1.1.1.1.1.2.5. yardstick.benchmark.runners.iteration module

A runner that runs a configurable number of times before it returns

class yardstick.benchmark.runners.iteration.IterationRunner(config, queue)[source]

Bases: yardstick.benchmark.runners.base.Runner

Run a scenario for a configurable number of times

If the scenario ends before the time has elapsed, it will be started again.

Parameters
iterations - amount of times the scenario will be run for
type: int unit: na default: 1
interval - time to wait between each scenario invocation
type: int unit: seconds default: 1 sec

1.1.1.1.1.2.6. yardstick.benchmark.runners.sequence module

A runner that every run changes a specified input value to the scenario. The input value in the sequence is specified in a list in the input file.

class yardstick.benchmark.runners.sequence.SequenceRunner(config, queue)[source]

Bases: yardstick.benchmark.runners.base.Runner

Run a scenario by changing an input value defined in a list

Parameters:
  • - time to wait between each scenario invocation (interval) – type: int unit: seconds default: 1 sec
  • - name of the option that is increased each invocation (scenario_option_name) – type: string unit: na default: none
  • - list of values which are executed in their respective scenarios (sequence) – type: [int] unit: na default: none

1.1.1.1.1.2.7. Module contents