Concepts

Pools

Reusable datasets for parameterizing scenario runs.

Pools provide shared, reusable data sources that job workloads draw from. They decouple test data from scenario logic, making scenarios portable and reusable across different environments.

Pool Types

ip_range

Generates IP addresses from a CIDR block. The full IP list is pre-built at initialization time.

type: pool
id: internal-network
ip_range:
  cidr: "10.0.0.0/16"
  sampling: random

Maximum size: 1,048,576 IPs (a /12 block).

string_list

A static list of string values.

type: pool
id: regions
string_list:
  values: ["us-east-1", "us-west-2", "eu-west-1"]
  sampling: round_robin

csv

Rows loaded from a CSV file. Each row becomes a record whose fields can be accessed via dot-path expressions.

type: pool
id: iam-users
csv:
  path: ./users.csv
  sampling: random

Sampling Modes

ModeBehavior
randomDraw a random record each time
round_robinCycle through records sequentially

Naming Rules

Pool IDs must not contain dots — use hyphens or underscores (e.g., iam-users, internal_network).