sdk

Documentation

Index

• type Span
• type SpanFromContext
• type SpanKind
• type SpanOptions
• type StartSpan

Types

type Span

type Span interface {
	// SetAttribute sets an attribute for the span.
	SetAttribute(key string, value interface{})

	// SetError sets an error for the span.
	SetError(err error)

	// IsNoop tells whether the span is noop or not, useful for avoiding
	// expensive recording.
	IsNoop() bool
}

Span is an interface that accept attributed and can be distinguished as noop

type SpanFromContext

type SpanFromContext func(ctx context.Context) Span

SpanFromContext retrieves the existing span from a context

type SpanKind

type SpanKind string

SpanKind represents the span kind, either Client, Server, Producer, Consumer or undertermine

const (
	Undetermined SpanKind = ""
	Client       SpanKind = "CLIENT"
	Server       SpanKind = "SERVER"
	Producer     SpanKind = "PRODUCER"
	Consumer     SpanKind = "CONSUMER"
)

type SpanOptions

type SpanOptions struct {
	Kind      SpanKind
	Timestamp time.Time
}

SpanOptions describes the options for starting a span

type StartSpan

type StartSpan func(ctx context.Context, name string, opts *SpanOptions) (context.Context, Span, func())

StartSpan creates a span and injects into a context, returning a span ender function