Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

trace

package

Go to main page

Versions in this module

v0

v0.17.0

May 7, 2026

v0.16.2

May 6, 2026

v0.16.1

May 6, 2026

v0.16.0

May 6, 2026

v0.15.2

May 5, 2026

v0.15.1

May 5, 2026

v0.15.0

May 4, 2026

Changes in this version

type Collector

+ func (c *Collector) RecordAIEffect(opName string, args []string, result string, route *ResolvedRoute)

type EffectEvent

+ Route *ResolvedRoute

+ type ResolvedRoute struct

+ CachedTokens int

+ CompletionTokens int

+ CostUSD string

+ FallbackChain []string

+ PromptTokens int

+ ReasoningTokens int

+ RequestedModel string

+ ResolvedModel string

+ ResolvedProvider string

v0.14.3

May 2, 2026

v0.14.2

Apr 26, 2026

v0.14.1

Apr 21, 2026

Changes in this version

+ func EmitOTELSpans(parentCtx context.Context, tracer oteltrace.Tracer, events []TraceEvent, ...) error

+ func EmitOTELSpansWithOptions(parentCtx context.Context, tracer oteltrace.Tracer, events []TraceEvent, ...) error

+ func ExportTrainingData(w io.Writer, traceFiles []string, cfg ExportConfig) (exported, skipped int, err error)

+ func IsNonDeterministic(effectName, opName string) bool

+ func TraceMetadata(events []TraceEvent) (moduleName string, caps []string)

+ func WriteJSONL(w io.Writer, events []TraceEvent) error

+ type BudgetEvent struct

+ Effect string

+ Limit int

+ Physical int

+ Remaining int

+ Used int

+ type Collector struct

+ OnEvent func(TraceEvent)

+ func NewCollector() *Collector

+ func (c *Collector) BaseTime() time.Time

+ func (c *Collector) Enabled() bool

+ func (c *Collector) Events() []TraceEvent

+ func (c *Collector) RecordBudgetDelta(effect string, used, limit, remaining, physical int)

+ func (c *Collector) RecordContractCheck(kind string, passed bool, msg, location, function string)

+ func (c *Collector) RecordEffect(effectName, opName string, args []string, result string)

+ func (c *Collector) RecordError(msg, location string)

+ func (c *Collector) RecordFunctionEnter(name string, args []string)

+ func (c *Collector) RecordFunctionExit(name string, result string)

+ func (c *Collector) RecordModuleEnd(name string, durationNS int64)

+ func (c *Collector) RecordModuleStart(name string, caps []string)

+ type CompareResult struct

+ BaselineN int

+ Match bool

+ Mismatches []Mismatch

+ ReplayN int

+ func CompareTraces(baseline, replay []TraceEvent) CompareResult

+ type ContractEvent struct

+ Function string

+ Kind string

+ Location string

+ Message string

+ Passed bool

+ type EffectEvent struct

+ Args []string

+ Deterministic *bool

+ EffectName string

+ OpName string

+ Result string

+ type ErrorEvent struct

+ Location string

+ Message string

+ type EventType string

+ const EventBudgetDelta

+ const EventContractCheck

+ const EventEffect

+ const EventError

+ const EventFunctionEnter

+ const EventFunctionExit

+ const EventModuleEnd

+ const EventModuleStart

+ type ExportConfig struct

+ MinScore float64

+ SourceDir string

+ type FunctionEvent struct

+ Args []string

+ DurationNS int64

+ Name string

+ Result string

+ type Mismatch struct

+ Actual string

+ Context string

+ Expected string

+ Field string

+ Index int

+ type ModuleEvent struct

+ Caps []string

+ DurationNS int64

+ Name string

+ type Tier int

+ const TierDeep

+ const TierOff

+ const TierStandard

+ func ParseTier(s string) (Tier, error)

+ func ResolveTier(cliFlag string) (Tier, error)

+ func TierFromEnv() (Tier, error)

+ func (t Tier) String() string

+ type TraceEvent struct

+ Budget *BudgetEvent

+ Contract *ContractEvent

+ Depth int

+ Effect *EffectEvent

+ Error *ErrorEvent

+ Event EventType

+ Function *FunctionEvent

+ Module *ModuleEvent

+ ParentSpanID string

+ SpanID string

+ TimestampNS int64

+ TraceID string

+ Version string

+ func ReadJSONL(r io.Reader) ([]TraceEvent, error)

+ type TraceScore struct

+ BudgetEfficiency float64

+ Completion float64

+ Complexity float64

+ ContractCoverage float64

+ EffectBreakdown map[string]int

+ EffectDiversity float64

+ FunctionCounts map[string]int

+ Stats TraceStats

+ Total float64

+ func ScoreTrace(events []TraceEvent) TraceScore

+ func ScoreTraceFile(path string) (TraceScore, error)

+ type TraceStats struct

+ BudgetEvents int

+ ContractChecks int

+ ContractsPassed int

+ DistinctEffects int

+ DistinctFunctions int

+ EffectCalls int

+ FunctionCalls int

+ HasErrors bool

+ HasModuleEnd bool

+ MaxDepth int

+ TotalEvents int

+ type TracingOptions struct

+ MaxSpansPerTrace int

+ Tier Tier

+ func DefaultTracingOptions() TracingOptions

+ func (o TracingOptions) DeepTrace() bool

+ func (o TracingOptions) Enabled() bool

+ type TrainingExample struct

+ Metadata TrainingMeta

+ Score float64

+ Source string

+ Trace string

+ type TrainingMeta struct

+ Caps []string

+ Effects []string

+ Events int

+ Functions int

+ MaxDepth int

+ Module string