[{"data":1,"prerenderedAt":240},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fv2\u002Ffleet\u002Fdebugging\u002Ftrace":3},{"id":4,"title":5,"body":6,"description":16,"extension":233,"meta":234,"navigation":235,"path":236,"seo":237,"stem":238,"__hash__":239},"docs\u002Fdocs\u002Fv2\u002Ffleet\u002Fdebugging\u002Ftrace.md","Trace & Events",{"type":7,"value":8,"toc":226},"minimark",[9,13,17,22,27,30,37,41,44,48,51,55,59,62,129,132,135,149,153,165,169,172,180,184,188,208,211,214],[10,11,5],"h1",{"id":12},"trace-events",[14,15,16],"p",{},"Two views over the same run. Events is what happened. Trace is that laid against time.",[18,19,21],"h2",{"id":20},"trace","Trace",[23,24],"terminal-image",{"alt":25,"src":26},"The Trace pane showing a flame graph of one run's engine, tool and capsule spans","\u002Ffleet\u002Ftrace-pane.png",[14,28,29],{},"A flame graph of the run's spans — engine calls, tool calls, capsule commands — nested by\nwhat spawned what, sized by how long they took.",[14,31,32,33],{},"It answers the question no log answers quickly: ",[34,35,36],"strong",{},"where did the time go?",[38,39],"terminal-video",{"src":40},"\u002Ffleet\u002Ftrace-zoom.mp4",[14,42,43],{},"The shape of a run is legible at a glance.",[23,45],{"alt":46,"src":47},"Three flame graphs: a healthy loop of short calls, one enormous engine call, and a staircase of repeating spans","\u002Ffleet\u002Ftrace-shapes.png",[14,49,50],{},"A tight sequence of short calls is a healthy loop. One enormous bar with nothing under it\nis an agent thinking with no tools. A staircase of near-identical spans is a loop that is\nnot converging.",[18,52,54],{"id":53},"events","Events",[23,56],{"alt":57,"src":58},"The Events pane showing the ordered runtime stream classified by namespace","\u002Ffleet\u002Fevents-pane.png",[14,60,61],{},"The full stream, in order, classified by namespace:",[63,64,65,76],"table",{},[66,67,68],"thead",{},[69,70,71,74],"tr",{},[72,73],"th",{},[72,75],{},[77,78,79,91,101,111,121],"tbody",{},[69,80,81,88],{},[82,83,84],"td",{},[85,86,87],"code",{},"build:",[82,89,90],{},"Resolving and preparing the agent",[69,92,93,98],{},[82,94,95],{},[85,96,97],{},"kernel:",[82,99,100],{},"The runtime's meter around engine calls, tools, the loop",[69,102,103,108],{},[82,104,105],{},[85,106,107],{},"cognet:",[82,109,110],{},"The brain narrating itself",[69,112,113,118],{},[82,114,115],{},[85,116,117],{},"capsule:",[82,119,120],{},"The sandbox — commands, processes, policy",[69,122,123,126],{},[82,124,125],{},"entries",[82,127,128],{},"The conversation: stimuli in, output and actions out",[38,130],{"src":131},"\u002Ffleet\u002Fevents-live.mp4",[14,133,134],{},"The three worth knowing by name:",[14,136,137,140,141,144,145,148],{},[85,138,139],{},"axon:agent:message"," — what it actually said.\n",[85,142,143],{},"capsule:stdin"," \u002F ",[85,146,147],{},"capsule:stdout"," — what it ran, and what came back.",[23,150],{"alt":151,"src":152},"A capsule command and its output in the event stream","\u002Ffleet\u002Fevents-capsule.png",[14,154,155,158,159,164],{},[85,156,157],{},"capsule:denied"," — what ",[160,161,163],"a",{"href":162},"\u002Fdocs\u002Fv2\u002Fagent\u002Fpolicy","policy"," stopped.",[23,166],{"alt":167,"src":168},"A denied capsule action in the event stream","\u002Ffleet\u002Fevents-denied.png",[14,170,171],{},"That last one saves the most time. An agent that \"ignored\" an instruction to edit a file\nvery often tried and was refused — which looks like a reasoning failure in the transcript\nand a one-line config fix here.",[14,173,174,175,179],{},"Entry types are documented under ",[160,176,178],{"href":177},"\u002Fdocs\u002Fv2\u002Fapi\u002Fthread\u002Findex","Entries",".",[18,181,183],{"id":182},"working-them-together","Working them together",[23,185],{"alt":186,"src":187},"Trace to Events to Engine — find the span, read what happened, see what the model was given","\u002Ffleet\u002Fdebug-flow.png",[189,190,191,197,202],"ol",{},[192,193,194,196],"li",{},[34,195,21],{}," — find the span where it went wrong.",[192,198,199,201],{},[34,200,54],{}," — read what happened around it.",[192,203,204,207],{},[34,205,206],{},"Engine"," — open that call and read what the model was given.",[14,209,210],{},"Most investigations end at step two. The ones that do not are context problems, and step\nthree is where those become visible.",[212,213],"hr",{},[14,215,216,217,221,222,179],{},"Back to ",[160,218,220],{"href":219},"\u002Fdocs\u002Fv2\u002Ffleet\u002Fdebugging","Debugging in Code",", or on to\n",[160,223,225],{"href":224},"\u002Fdocs\u002Fv2\u002Ffleet\u002Fmanagement","Managing Agents",{"title":227,"searchDepth":228,"depth":228,"links":229},"",2,[230,231,232],{"id":20,"depth":228,"text":21},{"id":53,"depth":228,"text":54},{"id":182,"depth":228,"text":183},"md",{},true,"\u002Fdocs\u002Fv2\u002Ffleet\u002Fdebugging\u002Ftrace",{"title":5,"description":16},"docs\u002Fv2\u002Ffleet\u002Fdebugging\u002Ftrace","sFXs6hHt2rPYQkGY_rez3PVbnUT-yAHGZ--PYWMRhU4",1786104361078]