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

tracing

package

Go to main page

Versions in this module

v1

v1.3.1-rp1

Feb 6, 2026

v1.2.21

Feb 18, 2026

v1.2.20

Feb 12, 2026

v1.2.19

Feb 10, 2026

v1.2.18

Feb 2, 2026

v1.2.17

Feb 2, 2026

v1.2.16

Jan 26, 2026

v1.2.15

Jan 26, 2026

v1.2.14

Jan 22, 2026

v1.2.13

Jan 21, 2026

v1.2.12

Jan 19, 2026

v1.2.11

Jan 18, 2026

v1.2.10

Jan 15, 2026

v1.2.9

Jan 15, 2026

v1.2.8

Jan 11, 2026

v1.2.7

Jan 9, 2026

v1.2.6

Jan 8, 2026

v1.2.5

Jan 7, 2026

v1.2.4

Jan 7, 2026

v1.2.3

Jan 5, 2026

v1.2.2

Jan 2, 2026

v1.2.1

Dec 30, 2025

Changes in this version

+ func ExtractTraceParentSpanID(header *fasthttp.RequestHeader) string

v1.2.0

Dec 29, 2025

Changes in this version

+ const TraceParentHeader

+ const TraceStateHeader

+ func AddChildSpan(ctx context.Context, store *TraceStore, parentSpanID, name string, ...) *schemas.Span

+ func AddSpan(ctx context.Context, store *TraceStore, name string, kind schemas.SpanKind) *schemas.Span

+ func AddSpanEvent(ctx context.Context, store *TraceStore, spanID string, event schemas.SpanEvent)

+ func EndSpan(ctx context.Context, store *TraceStore, spanID string, ...)

+ func ExtractParentID(header *fasthttp.RequestHeader) string

+ func FormatTraceparent(traceID, spanID, traceFlags string) string

+ func GetTrace(ctx context.Context, store *TraceStore) *schemas.Trace

+ func GetTraceID(ctx context.Context) string

+ func InjectTraceContext(header *fasthttp.RequestHeader, traceID, spanID, traceFlags, traceState string)

+ func PopulateBatchCancelRequestAttributes(req *schemas.BifrostBatchCancelRequest, attrs map[string]any)

+ func PopulateBatchCancelResponseAttributes(resp *schemas.BifrostBatchCancelResponse, attrs map[string]any)

+ func PopulateBatchCreateRequestAttributes(req *schemas.BifrostBatchCreateRequest, attrs map[string]any)

+ func PopulateBatchCreateResponseAttributes(resp *schemas.BifrostBatchCreateResponse, attrs map[string]any)

+ func PopulateBatchListRequestAttributes(req *schemas.BifrostBatchListRequest, attrs map[string]any)

+ func PopulateBatchListResponseAttributes(resp *schemas.BifrostBatchListResponse, attrs map[string]any)

+ func PopulateBatchResultsRequestAttributes(req *schemas.BifrostBatchResultsRequest, attrs map[string]any)

+ func PopulateBatchResultsResponseAttributes(resp *schemas.BifrostBatchResultsResponse, attrs map[string]any)

+ func PopulateBatchRetrieveRequestAttributes(req *schemas.BifrostBatchRetrieveRequest, attrs map[string]any)

+ func PopulateBatchRetrieveResponseAttributes(resp *schemas.BifrostBatchRetrieveResponse, attrs map[string]any)

+ func PopulateChatRequestAttributes(req *schemas.BifrostChatRequest, attrs map[string]any)

+ func PopulateChatResponseAttributes(resp *schemas.BifrostChatResponse, attrs map[string]any)

+ func PopulateContextAttributes(attrs map[string]any, virtualKeyID, virtualKeyName string, ...)

+ func PopulateCostAttribute(resp *schemas.BifrostResponse, pricingManager *modelcatalog.ModelCatalog, ...)

+ func PopulateEmbeddingRequestAttributes(req *schemas.BifrostEmbeddingRequest, attrs map[string]any)

+ func PopulateEmbeddingResponseAttributes(resp *schemas.BifrostEmbeddingResponse, attrs map[string]any)

+ func PopulateErrorAttributes(err *schemas.BifrostError) map[string]any

+ func PopulateFileContentRequestAttributes(req *schemas.BifrostFileContentRequest, attrs map[string]any)

+ func PopulateFileContentResponseAttributes(resp *schemas.BifrostFileContentResponse, attrs map[string]any)

+ func PopulateFileDeleteRequestAttributes(req *schemas.BifrostFileDeleteRequest, attrs map[string]any)

+ func PopulateFileDeleteResponseAttributes(resp *schemas.BifrostFileDeleteResponse, attrs map[string]any)

+ func PopulateFileListRequestAttributes(req *schemas.BifrostFileListRequest, attrs map[string]any)

+ func PopulateFileListResponseAttributes(resp *schemas.BifrostFileListResponse, attrs map[string]any)

+ func PopulateFileRetrieveRequestAttributes(req *schemas.BifrostFileRetrieveRequest, attrs map[string]any)

+ func PopulateFileRetrieveResponseAttributes(resp *schemas.BifrostFileRetrieveResponse, attrs map[string]any)

+ func PopulateFileUploadRequestAttributes(req *schemas.BifrostFileUploadRequest, attrs map[string]any)

+ func PopulateFileUploadResponseAttributes(resp *schemas.BifrostFileUploadResponse, attrs map[string]any)

+ func PopulateRequestAttributes(req *schemas.BifrostRequest) map[string]any

+ func PopulateResponseAttributes(resp *schemas.BifrostResponse) map[string]any

+ func PopulateResponsesRequestAttributes(req *schemas.BifrostResponsesRequest, attrs map[string]any)

+ func PopulateResponsesResponseAttributes(resp *schemas.BifrostResponsesResponse, attrs map[string]any)

+ func PopulateSpeechRequestAttributes(req *schemas.BifrostSpeechRequest, attrs map[string]any)

+ func PopulateSpeechResponseAttributes(resp *schemas.BifrostSpeechResponse, attrs map[string]any)

+ func PopulateTextCompletionRequestAttributes(req *schemas.BifrostTextCompletionRequest, attrs map[string]any)

+ func PopulateTextCompletionResponseAttributes(resp *schemas.BifrostTextCompletionResponse, attrs map[string]any)

+ func PopulateTranscriptionRequestAttributes(req *schemas.BifrostTranscriptionRequest, attrs map[string]any)

+ func PopulateTranscriptionResponseAttributes(resp *schemas.BifrostTranscriptionResponse, attrs map[string]any)

+ func SetSpanAttribute(ctx context.Context, store *TraceStore, spanID, key string, value any)

+ type AudioSummary struct

+ ID string

+ Transcript string

+ type DeferredSpanInfo struct

+ AccumulatedChunks []*schemas.BifrostResponse

+ FirstChunkTime time.Time

+ RequestID string

+ SpanID string

+ StartTime time.Time

+ Tracer schemas.Tracer

+ type MessageSummary struct

+ Audio *AudioSummary

+ Content string

+ Reasoning string

+ ReasoningDetails []ReasoningDetailSummary

+ Refusal string

+ Role string

+ ToolCalls []ToolCallSummary

+ type ReasoningDetailSummary struct

+ Text string

+ Type string

+ type ResponsesMessageSummary struct

+ Content string

+ Reasoning string

+ Role string

+ type ToolCallSummary struct

+ Args string

+ ID string

+ Name string

+ Type string

+ type TraceStore struct

+ func NewTraceStore(ttl time.Duration, logger schemas.Logger) *TraceStore

+ func (s *TraceStore) AppendStreamingChunk(traceID string, chunk *schemas.BifrostResponse)

+ func (s *TraceStore) ClearDeferredSpan(traceID string)

+ func (s *TraceStore) CompleteTrace(traceID string) *schemas.Trace

+ func (s *TraceStore) CreateTrace(parentID string) string

+ func (s *TraceStore) EndSpan(traceID, spanID string, status schemas.SpanStatus, statusMsg string, ...)

+ func (s *TraceStore) GetAccumulatedData(traceID string) ([]*schemas.BifrostResponse, int64)

+ func (s *TraceStore) GetDeferredSpan(traceID string) *DeferredSpanInfo

+ func (s *TraceStore) GetTrace(traceID string) *schemas.Trace

+ func (s *TraceStore) ReleaseTrace(trace *schemas.Trace)

+ func (s *TraceStore) StartChildSpan(traceID, parentSpanID, name string, kind schemas.SpanKind) *schemas.Span

+ func (s *TraceStore) StartSpan(traceID, name string, kind schemas.SpanKind) *schemas.Span

+ func (s *TraceStore) Stop()

+ func (s *TraceStore) StoreDeferredSpan(traceID, spanID string)

+ type Tracer struct

+ func NewTracer(store *TraceStore, pricingManager *modelcatalog.ModelCatalog, ...) *Tracer

+ func (t *Tracer) AddEvent(handle schemas.SpanHandle, name string, attrs map[string]any)

+ func (t *Tracer) AddStreamingChunk(traceID string, response *schemas.BifrostResponse)

+ func (t *Tracer) CleanupStreamAccumulator(traceID string)

+ func (t *Tracer) ClearDeferredSpan(traceID string)

+ func (t *Tracer) CreateStreamAccumulator(traceID string, startTime time.Time)

+ func (t *Tracer) CreateTrace(parentID string) string

+ func (t *Tracer) EndSpan(handle schemas.SpanHandle, status schemas.SpanStatus, statusMsg string)

+ func (t *Tracer) EndTrace(traceID string) *schemas.Trace

+ func (t *Tracer) GetAccumulatedChunks(traceID string) (*schemas.BifrostResponse, int64, int)

+ func (t *Tracer) GetAccumulator() *streaming.Accumulator

+ func (t *Tracer) GetDeferredSpanHandle(traceID string) schemas.SpanHandle

+ func (t *Tracer) GetDeferredSpanID(traceID string) string

+ func (t *Tracer) PopulateLLMRequestAttributes(handle schemas.SpanHandle, req *schemas.BifrostRequest)

+ func (t *Tracer) PopulateLLMResponseAttributes(handle schemas.SpanHandle, resp *schemas.BifrostResponse, ...)

+ func (t *Tracer) ProcessStreamingChunk(ctx *schemas.BifrostContext, traceID string, result *schemas.BifrostResponse, ...) *schemas.StreamAccumulatorResult

+ func (t *Tracer) ReleaseTrace(trace *schemas.Trace)

+ func (t *Tracer) SetAttribute(handle schemas.SpanHandle, key string, value any)

+ func (t *Tracer) StartSpan(ctx context.Context, name string, kind schemas.SpanKind) (context.Context, schemas.SpanHandle)

+ func (t *Tracer) Stop()

+ func (t *Tracer) StoreDeferredSpan(traceID string, handle schemas.SpanHandle)

+ type W3CTraceContext struct

+ ParentID string

+ TraceFlags string

+ TraceID string

+ TraceState string

+ func ExtractTraceContext(header *fasthttp.RequestHeader) *W3CTraceContext

+ func ParseTraceparent(traceparent string) *W3CTraceContext