types

Documentation

Index

• Constants
• type Event
• type RequestIDContextKey
• type Span
• type Trace
  • func (t *Trace) AddSpan(sp *Span)
  • func (t *Trace) GetSpans() []*Span

Constants

const (
	APIKeyHeader = "X-Honeycomb-Team"
	// libhoney-js uses this
	APIKeyHeaderShort = "X-Hny-Team"
	DatasetHeader     = "X-Honeycomb-Dataset"
	SampleRateHeader  = "X-Honeycomb-Samplerate"
	TimestampHeader   = "X-Honeycomb-Event-Time"
)

Types

type Event

type Event struct {
	Context    context.Context
	APIHost    string
	APIKey     string
	Dataset    string
	SampleRate uint
	Timestamp  time.Time
	Data       map[string]interface{}
}

event is not part of a trace - it's an event that showed up with no trace ID

type RequestIDContextKey

type RequestIDContextKey struct{}

used to put a request ID into the request context for logging

type Span

type Span struct {
	Event
	TraceID string
}

Span is an event that shows up with a trace ID, so will be part of a Trace

type Trace

type Trace struct {
	APIHost string
	APIKey  string
	Dataset string
	TraceID string

	// SampleRate should only be changed if the changer holds the SendSampleLock
	SampleRate uint
	// KeepSample should only be changed if the changer holds the SendSampleLock
	KeepSample bool
	// Sent should only be changed if the changer holds the SendSampleLock
	Sent bool

	SendBy time.Time

	// StartTime is the server time when the first span arrived for this trace.
	// Used to calculate how long traces spend sitting in Refinery
	StartTime time.Time

	HasRootSpan bool
	// contains filtered or unexported fields
}

Trace isn't something that shows up on the wire; it gets created within Refinery. Traces are not thread-safe; only one goroutine should be working with a trace object at a time.

func (*Trace) AddSpan

func (t *Trace) AddSpan(sp *Span)

AddSpan adds a span to this trace

func (*Trace) GetSpans

func (t *Trace) GetSpans() []*Span

GetSpans returns the list of spans in this trace