AgentTrace
Defined in: src/telemetry/tracer.ts:82
Execution trace for performance analysis. Tracks timing and hierarchy of operations within the agent loop. Fields default to null for JSON serialization compatibility.
Implements
Section titled “Implements”JSONSerializable<AgentTraceData>
Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new AgentTrace(name, options?): AgentTrace;Defined in: src/telemetry/tracer.ts:106
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
name | string | Display name for this trace |
options? | { parent?: AgentTrace; startTime?: number; } | Optional configuration for parent and startTime |
options.parent? | AgentTrace | - |
options.startTime? | number | - |
Returns
Section titled “Returns”AgentTrace
Properties
Section titled “Properties”readonly id: string;Defined in: src/telemetry/tracer.ts:84
Unique identifier (UUID) for this trace.
readonly name: string;Defined in: src/telemetry/tracer.ts:86
Human-readable display name (e.g., “Cycle 1”, “Tool: calc”, “stream_messages”).
parentId
Section titled “parentId”readonly parentId: string;Defined in: src/telemetry/tracer.ts:88
ID of the parent trace, if this trace is nested. Null for root traces.
startTime
Section titled “startTime”readonly startTime: number;Defined in: src/telemetry/tracer.ts:90
Start time in milliseconds since epoch.
endTime
Section titled “endTime”endTime: number = null;Defined in: src/telemetry/tracer.ts:92
End time in milliseconds since epoch. Null until trace is ended.
duration
Section titled “duration”duration: number = 0;Defined in: src/telemetry/tracer.ts:94
Duration in milliseconds (endTime - startTime).
children
Section titled “children”readonly children: AgentTrace[] = [];Defined in: src/telemetry/tracer.ts:96
Child traces nested under this trace.
metadata
Section titled “metadata”readonly metadata: Record<string, string> = {};Defined in: src/telemetry/tracer.ts:98
Additional metadata for this trace (e.g., cycleId, toolUseId, toolName).
message
Section titled “message”message: Message = null;Defined in: src/telemetry/tracer.ts:100
Message associated with this trace (e.g., model output). Null if not applicable.
Methods
Section titled “Methods”end(endTime?): void;Defined in: src/telemetry/tracer.ts:120
Parameters
Section titled “Parameters”| Parameter | Type | Description |
|---|---|---|
endTime? | number | Optional end time in milliseconds since epoch |
Returns
Section titled “Returns”void
toJSON()
Section titled “toJSON()”toJSON(): AgentTraceData;Defined in: src/telemetry/tracer.ts:125
Returns
Section titled “Returns”AgentTraceData
Implementation of
Section titled “Implementation of”JSONSerializable.toJSON