← Field Notes

You Can't Debug What You Can't Reason About

The observability gap in multi-agent AI, and why missing instrumentation is keeping agent systems out of production.

A few posts back, What Breaks When Nodes Have Judgment ended on seven words: you can't fix what you can't see. That was the gap nobody is talking about. This post is about why that gap is wider than anyone building agent systems today seems to realize, and what closing it actually requires.

In the microservices era, we went through a decade of painful maturation on observability. Four stages, roughly:

It started with logs. You could grep. You could tail. When something broke, you searched log files and, if you were lucky, found the error.

Then metrics. Dashboards. Alerts when the error rate crossed a threshold.

Then distributed tracing: Zipkin, Jaeger, eventually OpenTelemetry. Correlation IDs that followed a request across 12 services so you could finally answer: Why did this specific request fail?

Then semantic observability: Honeycomb, Lightstep, the ability to ask arbitrary questions about the behavior of your system, not just the metrics you thought to define in advance.

That journey took a decade. Multi-agent AI hasn't started it yet. And the failure modes are harder to see, because the failures don't look like failures. They look like confident answers.

Where We Are

Multi-agent AI is at the "we have logs" stage. Most agent frameworks emit logs. Some emit tool call traces, where you can see which tools were invoked, in what order, with what arguments.

What almost nobody can tell you:

  • Why a system of five agents produced a particular output
  • Which agent's reasoning was on the critical path
  • Where agents disagreed, and how disagreement was resolved
  • What each agent considered and rejected before arriving at its answer

That last one is the most important. In distributed systems, a trace gives you a call graph. In agent systems, what you actually need is a reasoning graph. Those are fundamentally different artifacts.

A call graph shows you what happened. A reasoning graph shows you why. We don't have the tools for the second one yet.

What The Path Forward Looks Like

The observability journey for agents will follow a familiar arc, but the telemetry is reasoning itself.

Stage 1 (now): Logs and tool traces. You can see what tools were called. You can't see why.

Stage 2: Agent interaction traces. End-to-end tracing of multi-agent conversations, with correlation IDs on thought chains. When agent A delegates to agent B, you can follow the thread. This is the distributed tracing moment, and it will make today's tool traces look incomplete.

Stage 3: Semantic reasoning graphs. Not just what happened, but what the agents were trying to do. Intent tracing. Disagreement logging. Confidence scoring at each step. The ability to ask: Which step in the reasoning chain introduced the error?

Stage 4: Continuous behavioral attestation. Not just "did this agent produce an output?" but "is this agent's reasoning consistent with its expected behavior?" Anomaly detection on reasoning patterns, not just error rates. The equivalent of SLOs, except the objective is semantic coherence, not latency.

Why This Is The Most Dangerous Gap

In distributed systems, bad observability was painful. You'd spend hours in a war room debugging incidents that good tracing would have resolved in minutes.

In multi-agent systems, bad observability is existential.

An agent system can fail semantically, producing confident, coherent, wrong outputs, with no operational signal. No error code. No timeout. No failed health check. Just bad reasoning, invisibly compounding across a chain of agents, making downstream decisions based on upstream errors you never caught.

When you can't see where the reasoning went wrong, you can't fix it. When you can't fix it, you can't trust it. When you can't trust it, you can't deploy it to anything that matters.

Agent observability isn't a nice-to-have. It's the prerequisite for multi-agent AI in production: for healthcare, for finance, for anything where a wrong answer has real consequences.

Who Builds The Reasoning Layer

The requirements are clear: distributed tracing adapted for reasoning chains, semantic anomaly detection, intent logging, and a query interface that lets you ask arbitrary questions about agent behavior. Not just "did it work?" but "why did it work that way, and was that the right way?"

Whoever builds that (the Datadog of agent systems) will build a generational company. They'll do it by understanding that agent observability isn't just better logging. The instrumentation layer has to be rethought from first principles, because the "work" being done isn't function calls. It's inference.

I'm watching several teams building toward this. The ones closest to getting it right are the ones who stopped trying to shoehorn APM into agents and started asking what observability means when the thing you're observing is reasoning, not execution.

The race has started. The window is open. This is the OpenTelemetry moment for AI.

Next: the security threat model nobody is ready for, and why the machine identity crisis is the defining AI security problem of our era.

All Field Notes ↗