Pools

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 or inline string. Each row becomes a record whose fields can be accessed via dot-path expressions.

Use path: to reference a file on disk, or data: to embed the CSV content directly in the pool YAML:

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

type: pool
id: iam-users
csv:
  data: |
    username,role
    alice,admin
    bob,viewer

Sampling Modes

Naming Rules

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