slo-load-test-plan

Produces one artifact: a load-test plan in which every scenario has a name, a load shape, an injection model, and a pass/fail line traceable to a stated SLO.

What this skill owns, and what it does not

The axis is time: this skill runs before a runner is chosen. Its output names metrics, shapes, and numbers in prose and tables, not in a runner's syntax. One short threshold snippet appears below purely to show what the numbers turn into; everything else stays declarative.

Step 1 - Derive named scenarios from SLOs

For every SLO in the input:

1. Identify the target metric: a latency percentile, an availability ratio, an error rate, or a throughput floor.
2. Map it to the endpoint or endpoint set it governs, weighted by the traffic mix (an endpoint carrying 60% of requests and one carrying 2% do not deserve equal scenario budget).
3. Name the scenario after the failure mode it validates, not after the endpoint. checkout-p95-under-peak-load tells a reader what a red run means; checkout-test-2 does not.

One SLO can yield several scenarios. Split whenever the boundary conditions differ: the same p95 target at average traffic and at peak traffic are two scenarios, because they need different load shapes and can fail independently.

Preserve the traffic mix inside each scenario. A scenario that sends 100% of its requests to the endpoint under test measures that endpoint in isolation, not in the contention it actually experiences.

Step 2 - Assign a load profile

Six canonical profiles, per the Grafana k6 test types guide (opens in new window). Every scenario from Step 1 gets exactly one.

Selection rules that follow from the definitions:

• A latency SLO stated "at normal traffic" takes average-load. Stated "at peak" or "with headroom", it takes stress.
• Any service with an availability SLO gets a soak scenario. Short runs cannot observe the failure modes that need hours to appear (memory growth, connection-pool and file-descriptor exhaustion, log-volume and disk effects).
• A stated spike event (sale day, campaign launch, cron fan-in) gets its own spike scenario at the stated multiple of peak, not a bigger stress run.
• Breakpoint is not a pass/fail scenario. It has no threshold, because its purpose is to find the ceiling by reaching failure. Record its result as a capacity number and run it only in an isolated environment.
• Every plan opens with a smoke scenario. It gates the rest: if smoke fails, the other results are measuring the script, not the service.

Step 3 - Choose the injection model per scenario

Each scenario also declares one of two workload models. This is the most frequently mis-stated concept in load-test planning, so state it precisely.

Closed model. A fixed population of virtual users, each finishing its current request before starting the next: "The next iteration doesn't start until the previous one finishes" (k6 open and closed models (opens in new window)). The consequence that matters for planning: throughput is coupled to latency. When the service slows down, offered load falls with it, so the test quietly stops applying the load you specified - k6 names this effect coordinated omission.

Open model. New iterations arrive at a rate you specify, independent of how long previous ones take, so "the response times of the target system no longer influence the load on the target system" (k6 open and closed models (opens in new window)). A degrading service keeps receiving the same arrival rate, so queues build the way they would in production.

For how k6 and Gatling name their open and closed executors, and the Gatling "users means open, not closed" trap, see references/runners.md.

Decision rule for the plan:

• The SLO or the traffic data is stated as a rate (RPS, orders per minute, events per second): choose open. This covers average-load, stress, and spike scenarios in almost every plan.
• The SLO or the constraint is stated as a concurrency level (seats, simultaneous sessions, a connection-pool or licence ceiling): choose closed, and say which resource the concurrency number represents.
• A soak follows the same rule as its underlying SLO. If availability is measured per request, soak open at the average arrival rate; if the service is a long-lived session product, soak closed at the target concurrency.
• Never choose closed for a scenario whose purpose is to observe behavior under overload. A closed run self-throttles as latency rises and will report a passing throughput that the service never actually sustained.

Step 4 - Derive threshold expressions from the SLO

Every scenario except breakpoint carries at least one threshold, and every threshold is a restatement of an SLO. Per the k6 thresholds documentation (opens in new window), a threshold expression has the form <aggregation_method> <operator> <value>, is evaluated against the metric collected during the run, and produces a non-zero exit code when it fails.

Mechanical translation:

Two rules keep the thresholds honest:

Scope each threshold to the endpoints its SLO governs. A whole-run p95 is dominated by whichever endpoint carries the most traffic, so a slow low-volume checkout hides behind a fast high-volume list call. Thresholds can be attached to a tagged subset of requests, written as metric_name{tag_name:tag_value}, for example http_req_duration{type:API} (k6 thresholds (opens in new window)). The plan states the tag per scenario; the implementer wires it.

Say per scenario whether a breach aborts the run. The long form of a threshold supports abortOnFail: true to stop execution on failure and delayAbortEval to postpone evaluation until enough data has accumulated, given as a relative time string such as '10s' (k6 thresholds (opens in new window)):

thresholds: {
  http_req_duration: [{ threshold: 'p(95)<300', abortOnFail: true, delayAbortEval: '10s' }],
  http_req_failed: ['rate<0.001'],
}

Abort when continuing costs something and teaches nothing:

• Any run against production or a shared environment, where continued load past a breach burns real error budget for real users.
• Long soaks, where a threshold broken in minute 8 will still be broken in hour 4 and the remaining hours only cost machine time.
• Any run whose smoke scenario has not passed.

Do not abort when the failure itself is the measurement: spike recovery (you want to see whether latency returns to baseline after the surge), stress scenarios exploring headroom, and breakpoint runs, which have no threshold to abort on at all.

Step 5 - Size the error budget and calibrate the soak

An error budget is what the SLO leaves over: "the error budget is 100% minus the SLO". The Google SRE Workbook's worked case: a 99.9% SLO on a service receiving 3 million requests over a four-week period allows a budget of 3,000 (0.1%) errors (Implementing SLOs (opens in new window)).

The formula the plan uses:

budget_events = (1 - SLO_target) x total_events_in_window

Calibrate the soak in three steps.

1. Size the production budget. State the window explicitly, because the budget is meaningless without one. Four weeks at an average 100 RPS is 2,419,200 seconds x 100 = 241,920,000 requests; at a 99.9% SLO the budget is 241,920 failed requests.
2. Set the soak's pass/fail line at its pro-rata share. A four-hour soak at 300 RPS issues 4,320,000 requests. Its share of the budget is (1 - 0.999) x 4,320,000 = 4,320 failures, which is exactly the SLO's own rate. So the threshold is rate<0.001, and the plan records how that number was reached rather than presenting 0.001 as a round number someone liked.
3. Add a burn-rate cap if the soak touches a live budget. Burn rate is "how fast, relative to the SLO, the service consumes the error budget" (Alerting on SLOs (opens in new window)); a constant error rate equal to the budget rate is a burn rate of 1, and double that rate exhausts the window's budget in half the time (Alerting on SLOs (opens in new window)). When the soak runs against production or any environment sharing the measured budget, cap the run so a single test cannot spend more than a stated fraction of the window's budget, and abort at that count. Half the window budget is a common practitioner convention, not a standard; pick the fraction deliberately and write it down. The SRE Workbook's own illustration of an incident causing 1,500 errors against a 3,000-error budget shows what a 50% draw looks like (Implementing SLOs (opens in new window)).

Every threshold in the plan should now be traceable: SLO, then window, then event count, then budget, then the number in the expression. A threshold that cannot be traced back this way is a guess.

Output format

One Markdown document:

## Load-test plan: <service> (<date>)

### SLO inventory
| SLO | Metric | Window | Current baseline | Source |

### Scenario matrix
| Scenario | SLO governed | Profile | Injection model | Target rate or concurrency | Duration |

### Profile definitions
For each scenario:
- Ramp: <start> to <peak> over <T>
- Plateau: hold <peak> for <T>
- Ramp-down: <peak> to 0 over <T>
- Injection model: open (arrivals/sec) | closed (concurrency), and why
- Traffic mix applied: <endpoint: weight, ...>

### Thresholds
| Scenario | Metric | Scope tag | Expression | Abort on fail | SLO it restates |

### Error-budget derivation
| SLO | Window | Total events | Budget events | Soak allowance | Burn-rate cap |

### Open questions
Anything the plan assumed rather than knew: peak RPS, growth rate, whether an
SLO is agreed or aspirational.

Worked example

A full worked example - a checkout service's four SLOs turned into a six-scenario matrix with per-scenario thresholds, each traceable back to its SLO - is in references/runners.md.

Anti-patterns

Limitations

• The plan is only as good as the traffic numbers it assumes. If peak RPS or the endpoint mix is wrong, every arrival rate in the matrix is wrong. Record the assumed numbers in the Open questions section so a reviewer can challenge them.
• No runnable artifact. The output is a planning document. Turning it into an executable run needs the chosen runner's own configuration.
• Single-service scope. A plan covers one service's endpoints. A flow that spans services (checkout calling inventory and payment) needs a plan per service plus an agreement on which one owns the end-to-end SLO.
• Breakpoint results are not comparable across environments. A ceiling found in staging bounds staging, not production, unless the two are provisioned identically.