Observability

The human can see what happened.

Observability is made of three disciplines: Capture, Availability, and Trace. Capture records each run as it happens: everything the agent was told, everything it did, and what it cost. Availability puts that record where your team can query it, not locked in a vendor console nobody opens. Trace reconstructs a single run end to end, like walking back through an agent's whole bug fix, reasoning included.

Observability

The human can see what happened.

Observability
The domain

The business outcome

Trust backed by evidence. You can reconstruct an incident, answer an auditor from the record instead of from memory, and see exactly where the AI spend goes.

Before investment

Agent work is a black box you pay for monthly. When output is wrong, nobody can say where the run went sideways, so debugging is guesswork and re-runs. The bill is one number with no breakdown, and when someone asks what the agent did, the honest answer is that you do not know.

After investment

A record exists for every run, and someone can open it. An incident becomes an afternoon reading a trace instead of a week of speculation, spend maps to teams and workflows, and questions about agent behavior are answered from the log.

The three disciplines

Capture

When an agent runs unsupervised, the only proof of what it did is whatever you thought to keep. Capture is the discipline of instrumenting the run so that proof exists: the prompts it received, the responses it gave, the tool calls it made, and the metadata around them, from cost and token spend to the model and platform behind each session.

The question

Are we recording what our agents do: the prompts, the responses, the tool calls, the cost?

Availability

Capture gets the work recorded, but a record no one can question is just storage. Availability is the discipline of organizing that record so anyone can put a question to it and get an answer: how often a tool call fails for a given reason, which sessions touched a service, where the spend is concentrated.

The question

When we want to look, is the data actually queryable, or buried where no one can reach it?

Trace

An agent's finished work does not explain how it got there. Trace is the discipline of answering that for a single run: every decision the agent made, and the rationale behind it, preserved from the opening prompt to the change that shipped.

The question

When something goes wrong, can we reconstruct exactly what the agent did and why?

In your org, each of these disciplines already sits at one of four investment tiers: , , , or . Every discipline page walks all four: what each tier buys, what it costs to maintain, and the techniques that get you there.

Domain overlap

Observability's three disciplines pay off in pairs, not alone. Some sit inside the domain; others reach across to wherever the record gets used. These are the overlaps worth funding together.

Within Observability

  • Capture and Trace

    A trace is only ever a reading of what Capture bothered to write down: reconstruct a decision and you are replaying the record, not the run, so reasoning-level Trace demands reasoning-level Capture. Instrument only the prompts and the tool calls and the trail can say what happened but never why, which is the half of an incident that actually costs you.

    Invest in both and a cold case reopens down to the judgment behind it. Under-fund Capture and Trace becomes a courtroom with no evidence: the event on the record, the reason for it gone.

  • Availability and Trace

    Availability and Trace answer opposite questions of the same record. Availability reads across every run at once while Trace goes vertical on one of them, the full walk of a single case down to the reasoning behind it.

    You need both postures, because a query that flags a spike in failures cannot tell you why any single one broke, and reconstructing that one broken run cannot tell you whether it is a fluke or a pattern. Fund only breadth and you are watching a trend you cannot diagnose; fund only depth and you are explaining a case you cannot place.

  • Capture and Availability

    Capture writes the record; Availability decides whether anyone can ever ask it anything. A session logged and then sealed away is the worst line on the bill: you paid for the instrumentation and the storage and bought back nothing, because the answer is technically in there and functionally gone.

    The two only pay off together: capture wide, then make it reachable. Log nothing and there is nothing to ask; log everything into a pit and you have funded a haystack no one will search.

Where Observability reaches across

  • Delegation and Trace

    Control

    You can only safely hand over a decision you are able to reconstruct later. Delegation is how much you let the agent settle on its own; Trace is what keeps those solo calls something you can still answer for when one goes wrong.

    Push the line out past what you can trace and every autonomous decision becomes a call with no path back to the reasoning behind it, which is exactly the call an incident or an auditor will make you explain. So the honest ceiling on how far you delegate is how deep you can reconstruct: widen the line and the record together, or the reach you handed over is reach you cannot account for.

  • Trace and Convergence

    Improvement

    A reconstruction tells you exactly what went wrong, and by itself changes nothing about what happens next. Trace is the practice that produces the finding: the walk back through a run to the decision that broke it. Convergence is the practice that turns that finding into something the whole team now does differently.

    Same evidence, two jobs: fund the first alone and you accumulate immaculate postmortems on incidents you are still on course to repeat, because a lesson learned in one investigation is not a lesson the team has adopted until someone makes it spread.

  • Capture and Evaluation

    Improvement

    Capture supplies the raw record of what the agent did; Evaluation is the judgment of whether it was any good. The record is the evidence Evaluation reasons from: with nothing captured to compare against, a claimed improvement is just a better-feeling week, and the evals fire on data someone had to record first.

    But a full log still cannot render the verdict, because good is judged against a standard the record does not contain: the rubric, a senior engineer's read, whether the output served a customer the log never saw. Capture the work without ever judging it and you are archiving activity no one grades; judge with no captured record and you are grading from memory, the exact feeling Evaluation exists to replace.

  • Availability and Prioritization

    Improvement

    Prioritization runs on the signal it can actually pull, and Availability is what decides whether that signal is reachable at all. A queryable record answers the questions a sound investment call rests on: where the spend is piling up, which failures recur, what a workflow really costs the team.

    Leave the record unreachable and Prioritization has nothing to read, so it quietly falls back to whoever argues hardest, the very failure mode both disciplines are built to prevent. Make the record queryable and the next bet gets chosen from evidence anyone can check, not from the meeting's center of gravity.

  • Collection and Capture

    Context

    Collection and Capture are one instinct aimed in opposite directions: Collection gathers what an agent needs before a run, Capture records what it did after. They rhyme because the record Capture writes down (the decision made, the reasoning behind it, the transcript of how the work actually went) is exactly the kind of artifact Collection exists to feed the next agent.

    Instrument every run but never gather from what you logged and a true account of how your team works with AI piles up unread; gather diligently while capturing nothing and you curate only the sources that predate your agents, missing the richest one. The payoff is a loop: the exhaust of one session becomes the context that orients the next.

Browse the framework
You are here
Observability

The human can see what happened.

  • CaptureMaking sure every run leaves a raw record.
  • AvailabilityPutting the record of agent work where your team can query and review it.
  • TraceWalking back through a single run, end to end, with the reasoning alongside the decisions.