Agent Know-How
Agent engineering · know-how
You can't see why an agent did what it did
🧱 Obstacle·observability·active·16 sources·updated 2026-08-12
When an agent does the wrong thing, the run that produced it is a long, non-deterministic chain of model calls, tool results, and intermediate decisions — and most of that is invisible after the fact. Unlike a stack trace, an agent's "why" is spread across a trajectory you didn't log in enough detail, can't replay deterministically, and can't easily diff against a working run. Debugging an agent is increasingly the job, not a footnote to it.
Observability for agents is splitting from generic APM into a trace-first discipline: the unit you capture is the full trajectory (prompts, tool calls, results, retries, sub-agent handoffs), and the work is making that trajectory queryable, diffable, and explainable. Tooling is consolidating around a common trace format and then layering analysis on top — open-source debuggers ingest traces from the emerging standards (Langfuse, Arize/OpenInference, or plain JSONL) and run a model *over the traces themselves* to surface recurring failure patterns rather than make an engineer read every span (HALO). Vendors are pushing the same idea up the stack into managed triage: LangSmith now ships a fleet on-call copilot for alert triage and dedicated voice/trace debugging, treating "read the traces and tell me what's breaking" as an agentic product rather than a dashboard. A second front is monitoring agents you can't fully trace at runtime — offline behavior monitoring evaluates internal agents from logged activity after the fact, which matters when live instrumentation is incomplete or the agent runs where you can't watch it. The hard, still-open part is *evaluating the monitoring itself*: a multi-dataset benchmark for LLM agents in microservice failure diagnosis (AgentOps) exists precisely because "did the agent correctly diagnose the failure" is itself a trajectory-grading problem over multimodal observability data — so agent observability and evaluation are converging, with the trace as the shared substrate.
Instrumentation is also showing up inside the coding-agent product itself, not just in third-party observability tooling: Claude Code now emits workflow.run_id and workflow.name as OpenTelemetry attributes, so a multi-agent workflow run is traceable through the same OTel pipeline a team already operates for the rest of its stack, rather than requiring a bespoke exporter. Enterprise case studies are catching up to the same convergence from the ops side: Schneider Electric built its LLMOps foundations on LangSmith specifically to unify observability, evaluation, and deployment at scale — a real deployment of the "trace as shared substrate" idea, not just a vendor pitch for it.
Trace debugging is also going cross-vendor: LangSmith now positions itself as the debug console for whichever coding agent a developer reaches for — Claude Code, Codex, Cursor, or Copilot — inspecting tool calls, sub-agent handoffs, errors, cost, and retries in one place instead of reading each tool's own logs, treating "which agent produced this trace" as a detail the observability layer should abstract away.
A self-hosted control-plane pattern is emerging alongside the managed vendors above: AWS's Claude Apps Gateway is a stateless container an organization runs itself in front of Claude Code/Desktop, relaying per-request usage metrics to the team's own OpenTelemetry collector (CloudWatch, Prometheus) while enforcing YAML-defined spend caps by org, group, or user — folding telemetry relay and cost policy into one customer-owned layer instead of a vendor dashboard. A managed vendor is now meeting that self-hosted instinct partway: LangSmith's Bring Your Own Cloud option reached general availability on AWS, giving an enterprise team managed observability, evaluation, and deployment while the workload itself stays inside their own VPC — the same "keep it in our network" requirement the Claude Apps Gateway answers by self-hosting, here answered by a vendor deploying its managed product into the customer's cloud instead.
Trace-first observability is also widening to a new modality: LangSmith now traces voice agents built on Pipecat, LiveKit, OpenAI Realtime, and Gemini Live, capturing audio, STT/TTS latency, interruptions, and tool calls in one trace — the same trajectory-capture discipline this page tracks for text-based agent loops, extended to the turn-taking and latency-sensitive failure modes specific to a spoken interface (see agent latency for why voice has a harder real-time floor than text).
A named enterprise deployment backs the trace-plus-LLM-analysis pattern with a production system: Expedia's STAR (built on FastAPI, Datadog, Celery, Redis, and Langfuse) ingests service telemetry during live incidents, runs it through structured workflows to generate root-cause assessments, and keeps engineers in the loop for the final call rather than auto-resolving — an instance of the trace-first, agentic-analysis pattern (HALO, LangSmith's on-call copilot) built on infrastructure a platform team already runs, not a new observability product.
A named experiment sharpens where the RCA bottleneck actually sits: a Coroot test running root-cause analysis across eleven models finds LLMs can already do the reasoning once given correctly prepared context, which reframes the hard problem from "can the model reason about the failure" to "can the pipeline correlate telemetry into that context" — the same context-assembly work Expedia's STAR already invests in rather than a bigger model. The self-hosted, indie tooling layer keeps growing alongside the vendor consolidation this page tracks: a Show HN entrant ships observability specifically for coding agents and LLM applications, one more option in the trace-first tooling space beyond the named vendors above.
A new benchmark puts a number on how far that reasoning-vs-pipeline gap still has to close: ORCA-bench pairs a live, OpenTelemetry-instrumented microservice testbed (six days of metrics, logs, and traces through Prometheus, Jaeger, and OpenSearch) with 1,079 oncall root-cause-analysis tasks graded by an LLM-as-judge independently re-scored by human SREs (agreement κ=0.90). Across five frontier agents the best RCA accuracy is 25.3% on realistic-input tasks and 10.0% on hard ones — a gap that holds even for Claude Fable 5, and the weakest model hallucinates an implausible root cause on 40% of reports. Since the testbed is a curated 50GB slice of a public system, the authors read this as a lower bound on the real-world gap, sharpening the Coroot finding above: the reasoning may already be there, but the end-to-end oncall pipeline this page tracks (telemetry correlation, ambiguous reports, time pressure) is still mostly unsolved.
A named production deployment pairs tracing with a human-approval gate rather than auto-resolving: LangChain built an autonomous SRE agent for Kubernetes on Deep Agents that requires human approval before it applies a change, with every step, tool call, and decision captured in LangSmith traces — an instance of the trace-first, agentic-analysis pattern above (Expedia's STAR, HALO) where the trace is also what a human reviews before the agent is allowed to act, not just what an engineer replays afterward.
Capture tooling itself is widening on the open-source side: Simon Willison's llm CLI (0.32) adds support for visible reasoning traces and redesigned, smarter logging alongside server-side provider tools — the same trajectory-capture discipline the vendor platforms above ship, now available in a widely-used, framework-agnostic command-line tool rather than only a hosted product.
LangSmith's Bring Your Own Cloud option reached general availability on AWS — managed observability, evaluation, and deployment with the workload kept inside the customer's own VPC, meeting the self-hosted control-plane pattern this page already tracks (AWS's Claude Apps Gateway) from the vendor side rather than the customer-built side.
Prior update: LangChain's autonomous Kubernetes SRE agent pairs LangSmith tracing with a human-approval gate before any change is applied — the trace doubles as what a human reviews before the agent acts, not only what an engineer replays after an incident.
Prior update: ORCA-bench measures oncall root-cause analysis directly for the first time on this page: across five frontier agents on 1,079 tasks against a live instrumented microservice testbed, the best RCA accuracy is 25.3% on realistic-input tasks and only 10.0% on hard ones, with the weakest model hallucinating a root cause 40% of the time — a concrete lower bound on how far agent oncall reasoning still has to go, even as the Coroot finding above shows the raw reasoning step already works when the context is prepared well.
You cannot operate what you cannot explain. Without trajectory-level traces, a regression after a model upgrade, a silent tool failure, or a runaway loop is invisible until it shows up as cost or a user complaint — and you have no way to reproduce it. Observability is the precondition for the rest of the stack: evaluation needs traces to grade, cost control needs per-step attribution, and incident response needs a replayable run. The build-vs-buy question is whether to standardize on a trace format and own the analysis, or adopt a managed platform — but either way the trace is the new log line.
- Show HN: RLM-based local debugger for AI agent traces
- June 2026: LangChain Newsletter — Fleet On-Call Copilot, Deep Agents Rubrics, and More
- Evaluating Offline Monitoring of Internal AI Agents
- A Multi-Dataset Benchmark for Evaluating LLM Agents in Microservice Failure Diagnosis
- How Schneider Electric Built Their LLMOps Foundations With LangSmith
- claude-code v2.1.202
- How to Debug Coding Agents with LangSmith Traces
- AWS Ships Claude Apps Gateway as Self-Hosted Control Plane for Claude Code and Claude Desktop
- Trace voice agents in LangSmith
- Expedia Uses AI Driven Service Telemetry Analyzer to Accelerate Incident Investigation
- AI Root Cause Analysis Shifts from Model Reasoning to Context Engineering
- Show HN: Observability for Coding Agents and LLM Applications
- ORCA-bench: How Ready Are Language Model Agents for Oncall?
- How we built an autonomous SRE agent for Kubernetes
- New release of LLM adds support for reasoning traces, OpenAI Responses, server-side tools, and smarter logging
- LangSmith BYOC on AWS is generally available