SessionTrace
Structured session trace emitted when the root session span ends. Computed from spans and hook/stream state collected during the session.
Properties
Section titled “Properties”agentId
Section titled “agentId”agentId: string;durationMs
Section titled “durationMs”durationMs: number;endTime
Section titled “endTime”endTime: number;errors
Section titled “errors”errors: object[];| Name | Type |
|---|---|
|
|
|
|
|
|
extractionSubmissions
Section titled “extractionSubmissions”extractionSubmissions: object[];| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
flowTransitions
Section titled “flowTransitions”flowTransitions: object[];| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
handoffs
Section titled “handoffs”handoffs: object[];| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
latency
Section titled “latency”latency: object;| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
peakContextUtilization?
Section titled “peakContextUtilization?”optional peakContextUtilization?: number;perTurnUsage?
Section titled “perTurnUsage?”optional perTurnUsage?: TurnUsage[];sessionId
Section titled “sessionId”sessionId: string;spans: Span[];startTime
Section titled “startTime”startTime: number;success
Section titled “success”success: boolean;toolCalls
Section titled “toolCalls”toolCalls: object[];| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
totalCacheReadTokens?
Section titled “totalCacheReadTokens?”optional totalCacheReadTokens?: number;totalInputTokens?
Section titled “totalInputTokens?”optional totalInputTokens?: number;Present when token observability recorded at least one LLM call.
totalOutputTokens?
Section titled “totalOutputTokens?”optional totalOutputTokens?: number;totalTokens?
Section titled “totalTokens?”optional totalTokens?: number;Session-level total tokens (provider-reported sums).
turnCount
Section titled “turnCount”turnCount: number;voice?
Section titled “voice?”optional voice?: object;Voice-specific metrics; omitted when no voice activity was recorded.
| Name | Type |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|