export

Documentation

Overview

Package export holds the definition of the telemetry Exporter interface, along with some simple implementations. Larger more complex exporters are in sub packages of their own.

Index

• func ContextSpan(ctx context.Context, event telemetry.Event) context.Context
• func Detach(ctx context.Context) context.Context
• func Metric(ctx context.Context, data telemetry.MetricData)
• func ProcessEvent(ctx context.Context, event telemetry.Event) context.Context
• func SetExporter(e Exporter)
• func Tag(ctx context.Context, at time.Time, tags telemetry.TagList)
• type Exporter
  • func LogWriter(w io.Writer, onlyErrors bool) Exporter
• type Span
  • func GetSpan(ctx context.Context) *Span
  • func (s *Span) Format(f fmt.State, r rune)
• type SpanContext
  • func (s *SpanContext) Format(f fmt.State, r rune)
• type SpanID
  • func (s SpanID) IsValid() bool
  • func (s SpanID) String() string
• type TraceID
  • func (t TraceID) String() string

Functions

func ContextSpan

func ContextSpan(ctx context.Context, event telemetry.Event) context.Context

func Detach

func Detach(ctx context.Context) context.Context

Detach returns a context without an associated span. This allows the creation of spans that are not children of the current span.

func Metric

func Metric(ctx context.Context, data telemetry.MetricData)

func ProcessEvent

func ProcessEvent(ctx context.Context, event telemetry.Event) context.Context

func SetExporter

func SetExporter(e Exporter)

func Tag

func Tag(ctx context.Context, at time.Time, tags telemetry.TagList)

Types

type Exporter

type Exporter interface {
	// ProcessEvent is a function that handles all events.
	// Exporters may use information in the context to decide what to do with a
	// given event.
	ProcessEvent(context.Context, telemetry.Event) context.Context

	Metric(context.Context, telemetry.MetricData)
}

func LogWriter

func LogWriter(w io.Writer, onlyErrors bool) Exporter

LogWriter returns an observer that logs events to the supplied writer. If onlyErrors is true it does not log any event that did not have an associated error. It ignores all telemetry other than log events.

type Span

type Span struct {
	Name     string
	ID       SpanContext
	ParentID SpanID
	Start    time.Time
	Finish   time.Time
	Tags     telemetry.TagList
	Events   []telemetry.Event
}

func GetSpan

func GetSpan(ctx context.Context) *Span

func (*Span) Format

func (s *Span) Format(f fmt.State, r rune)

type SpanContext

type SpanContext struct {
	TraceID TraceID
	SpanID  SpanID
}

func (*SpanContext) Format

func (s *SpanContext) Format(f fmt.State, r rune)

type SpanID

type SpanID [8]byte

func (SpanID) IsValid

func (s SpanID) IsValid() bool

func (SpanID) String

func (s SpanID) String() string

type TraceID

type TraceID [16]byte

func (TraceID) String

func (t TraceID) String() string