Find out why a session ended
When an agent run stops before its task is done, its session in Audit says why: an end reason, the recorded cause, and sometimes the last output its node's terminal showed. Use it to tell a model refusal from a node that went away, or to spot one machine that keeps ending runs the same way.
Who can do this: viewing Sessions needs a role that can view sessions (any project role, or Org Admin or Org Owner), and your plan must include Session transcripts. Opening a pane log and deleting a row need a role that can download transcripts: Project Maintainer, Org Admin or Org Owner.
-
In the sidebar, select Audit, then the Sessions tab.
-
Set Window to how far back to look, such as Last 7 days, or All time. It starts on Last 24 hours.
-
Set Status to Ended.
-
Set End reason to the kind of end you are after. Each reason shows how many sessions ended that way; Any end reason shows them all. To look at one machine, set Node too.
-
Read the session's row. Hover the ■ beside its name for the status and end reason in words; the lines under the row give the recorded cause, in red when it explains a failed run, and any Node log: lines. No pane log on node means the node kept no output to show.
-
Select ⋯ at the end of the row, then Pane log. It is offered only when the node sent one.
-
On the pane log, read End reason in the line of facts above the log, beside Node, Task and Ended · last written. The log opens at its end, where the newest lines are; select Wrap if a long line runs past the edge. If it says Written after this run ended; may show a later run., the lines may belong to a later run of the same task.
-
Select Copy to copy the whole log, for example into a task comment. Treat it as sensitive: only the secrets Jaah recognizes are removed.
-
Select Sessions above the title to go back to that session's row.
Delete a stale row
A session that was dispatched but never started never ends, so its row stays with nothing to finish it. Only such a row can be deleted; on any other the Delete item is greyed with the reason.
- Select ⋯ on the stale session's row, then Delete.
- The Delete this session row? dialog says the row is the only record that the session was dispatched. Select Delete session. There is no undo.
To clear every stale session at once, use Show them, then Delete … sessions, in the yellow banner above the filters.
Related
- Follow a task's sessions — every run of one task, including the runs that never started a session.
- How audit works — what Sessions records and the states a session goes through.
- Sessions — every filter, column, menu item and message on the screen, and the pane log.