AgentTrace
Defined in: src/telemetry/tracer.ts:73
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:97
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:75
Unique identifier (UUID) for this trace.
readonly name: string;Defined in: src/telemetry/tracer.ts:77
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:79
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:81
Start time in milliseconds since epoch.
endTime
Section titled “endTime”endTime: number = null;Defined in: src/telemetry/tracer.ts:83
End time in milliseconds since epoch. Null until trace is ended.
duration
Section titled “duration”duration: number = 0;Defined in: src/telemetry/tracer.ts:85
Duration in milliseconds (endTime - startTime).
children
Section titled “children”readonly children: AgentTrace[] = [];Defined in: src/telemetry/tracer.ts:87
Child traces nested under this trace.
metadata
Section titled “metadata”readonly metadata: Record<string, string> = {};Defined in: src/telemetry/tracer.ts:89
Additional metadata for this trace (e.g., cycleId, toolUseId, toolName).
message
Section titled “message”message: Message = null;Defined in: src/telemetry/tracer.ts:91
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:111
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:116
Returns
Section titled “Returns”AgentTraceData
Implementation of
Section titled “Implementation of”JSONSerializable.toJSON