Skip to content
Clairos Learn

Observability and tracing · Lesson 4 of 15 · 7 min

Compare throughput signals

Requests per second and tokens per second measure different throughput. Workload length can change token throughput without the same change in request throughput.

Mastery 0/3Run itExplain itApply it
learner@clairosSimulated AI Ops lab
learner@clairos:~ $
↑ history · Tab complete · Ctrl+C cancel · Esc, Tab to leaveExit 0

Understand the pattern

Requests per second and tokens per second measure different throughput. Workload length can change token throughput without the same change in request throughput.

Interpret the evidence

Keep request and token throughput separate; the observed mean is 30 output tokens per request.

A tempting mistake

Treat requests per second and tokens per second as interchangeable.

All names, measurements, prices, versions, and thresholds in this exercise are fictional training data. The evidence supports this bounded scenario, not a claim about a live provider.

Worked example and expected result
$ cat /opt/ai-lab/cases/aiops-observability-tracing-004.json
{
  "fixture": "Fictional training data; not a live measurement.",
  "requests_per_second": 20,
  "output_tokens_per_second": 600,
  "mean_output_tokens": 30
}

Exit status: 0. The command completed successfully in the training fixture.

$ jq .mean_output_tokens /opt/ai-lab/cases/aiops-observability-tracing-004.json
30

Exit status: 0. The command completed successfully in the training fixture.

$ printf '%s\n' 'keep-throughput-units' > /home/learner/lab/aiops-observability-tracing-004-decision.txt
(no output; exit 0)

Exit status: 0. The command completed successfully in the training fixture.

Try a variation

Name the assumption that would have to change for “keep-throughput-units” to stop being the justified action. Do not silently replace missing evidence with a guess.

Explain it

What does the evidence in “Compare throughput signals” justify?

Apply it elsewhere

A colleague concludes: “Treat requests per second and tokens per second as interchangeable.” What should you do?

Keep the momentum.

Complete the lab, then explain and apply the pattern.

Next: Inspect error-rate evidenceTry an incident drill

Anonymous lesson and mastery progress lasts for this session. Sign in to keep synced lesson XP between sessions; mastery stays device-local. No speed bonus, lost lives, or hint penalties.

Keep learning

  1. 01Read latency percentilesA p95 latency describes a percentile within an observed window. It does not mean that every request or the average request has that latency.Practice
  2. 02Inspect error-rate evidenceAn error rate needs both failures and total eligible requests over a stated window. A count of failures without a denominator cannot show the rate.Practice
  3. 03Follow a request traceA trace follows one request through its spans. Use parent-child relationships and IDs so unrelated concurrent work does not get included in the incident path.Practice