trace

Documentation

Overview

Package trace provides utilities for creating and submitting traces in serverless-init

Index

• func InitSpan(service, name, resource, spanType string, startTime int64, ...) *pb.Span
• func SubmitSpan(span *pb.Span, origin string, traceAgent Processor)
• type CloudRunJobsSpanModifier
  • func NewCloudRunJobsSpanModifier(jobSpan *pb.Span) *CloudRunJobsSpanModifier
  • func (m *CloudRunJobsSpanModifier) ModifySpan(_ *pb.TraceChunk, span *pb.Span)
• type Processor
• type SpanModifierSetter

Functions

func InitSpan

func InitSpan(service, name, resource, spanType string, startTime int64, tags map[string]string) *pb.Span

InitSpan creates a new span with the provided metadata

func SubmitSpan

func SubmitSpan(span *pb.Span, origin string, traceAgent Processor)

SubmitSpan submits a completed span to the trace agent

Types

type CloudRunJobsSpanModifier

type CloudRunJobsSpanModifier struct {
	// contains filtered or unexported fields
}

CloudRunJobsSpanModifier reparents user spans under the Cloud Run Job span.

This modifier adopts the TraceID from the first span seen (regardless of ParentID) and only reparents root spans (ParentID=0). Child spans are left unmodified to preserve the original span hierarchy.

In trace propagation scenarios where all spans have non-zero ParentIDs, the job span will be "floating" (unparented) within the trace. This is an acceptable trade-off as all spans will still share the same TraceID for log-trace correlation.

func NewCloudRunJobsSpanModifier

func NewCloudRunJobsSpanModifier(jobSpan *pb.Span) *CloudRunJobsSpanModifier

NewCloudRunJobsSpanModifier creates a new span modifier for Cloud Run Jobs

func (*CloudRunJobsSpanModifier) ModifySpan

func (m *CloudRunJobsSpanModifier) ModifySpan(_ *pb.TraceChunk, span *pb.Span)

ModifySpan reparents user spans under the Cloud Run Job span

type Processor

type Processor interface {
	Process(*api.Payload)
}

Processor is an interface for processing trace payloads

type SpanModifierSetter

type SpanModifierSetter interface {
	SetSpanModifier(agent.SpanModifier)
}

SpanModifierSetter is an interface for setting span modifiers