octoperf-sla

Design SLA profiles — pass/fail bands on a test's own metrics

Define what "too slow" and "too many errors" mean for a Virtual User, so a run raises alarms instead of leaving someone to eyeball the report. Read this before creating or editing an SLA profile.

Two different things are called SLA

Get this right first — the tools do not overlap.

	Design SLA profile (this skill)	SLA monitor (create_sla_monitor)
Scope	attached to a Virtual User	created on a project
Metrics	the ones you pick, with your bands	a fixed default set of per-request counters
Set up	create_sla_profile → attach_sla_profile_to_virtual_user	one call, pick an UP agent
Use it when	you have a target to enforce ("checkout under 1s")	you want per-request SLA counters with no thinking

They can coexist on the same project. create_sla_monitor is documented in octoperf://skills/monitoring; everything below is about profiles.

Both show up under Pass Criteria on the scenario page, next to the thresholds of the project's other monitors — what a passed run means, in one place. octoperf://skills/scenario-composition says what that step covers and how to read the criteria a test already has.

Mental model

A profile is a named set of threshold groups. One group = one metric plus the graded bands that fire on it:

SLAProfile "Checkout SLA"
└── SLAMonitorThreshold  metric = RESPONSE_TIME_AVG
    ├── Threshold  WARNING   value > 1000 ms   for 10 samples
    └── Threshold  CRITICAL  value > 3000 ms   for 3 samples

A band carries three things:

• severity — PASSED, WARNING or CRITICAL. PASSED is not decoration: some metrics (Apdex, hits rate) declare the good band explicitly.
• value — a range: lowerEndpoint / upperEndpoint with OPEN (exclusive) or CLOSED (inclusive) bound types. An omitted endpoint means unbounded — {lowerEndpoint: 5, lowerBoundType: "CLOSED"} is "5 or more".
• time — how long it must hold before firing, one of two shapes: {"@type":"OccurrenceCondition","times":10} (10 samples in a row) or {"@type":"DurationCondition","duration":30000} (milliseconds, not seconds).