Skip to content
Docs
GitHub

Summarize a session's trace

Preview

Summarize a session’s trace: turn, step and error totals, a minimap of turn buckets, and the turns that failed.

Public APIEverruns Cloud and self-hosted Platform

GET/v1/sessions/{session_id}/trace

See authentication for credentials and permissions.

session_id
required
string

Prefixed public identifier

buckets
integer format: int32

Minimap buckets wanted, 1 to 500. Defaults to 120.

Responses

200Success

Success

Media typeapplication/json

Session-wide trace summary and minimap.

object
bucket_size
required

Turns per minimap bucket.

integer format: int32
buckets
required

Minimap buckets in turn order.

Array<object>

A range of turns on the minimap.

object
duration_ms
required

Summed turn durations.

integer format: int64
errors
required

Failed steps and turns in the bucket.

integer format: int64
from_turn
required

First turn in the bucket.

integer format: int32
steps
required

Steps across the bucket’s turns.

integer format: int64
to_turn
required

Last turn in the bucket.

integer format: int32
error_count
required

Steps and turns that failed, across the session.

integer format: int64
error_turns
required

Turns with errors, newest first, at most 500.

Array<integer>
first_started_at

Start of the first turn.

string | null format: date-time
input_tokens
required

Prompt tokens across all model calls.

integer format: int64
last_activity_at

Latest start or end of any turn.

string | null format: date-time
output_tokens
required

Completion tokens across all model calls.

integer format: int64
step_count
required

Steps across all turns.

integer format: int64
turn_count
required

Turns in the session.

integer format: int64

Example

{
"bucket_size": 10,
"buckets": [
{
"duration_ms": 421000,
"errors": 2,
"from_turn": 1,
"steps": 142,
"to_turn": 10
}
],
"error_count": 27,
"input_tokens": 4812330,
"output_tokens": 91204,
"step_count": 18311,
"turn_count": 1240
}