spanlog

README

golang.org/x/build/internal/spanlog

Package spanlog provides span and event logger interfaces.

Documentation

Overview

Package spanlog provides span and event logger interfaces.

Index

• type Logger
• type Span

Types

type Logger

type Logger interface {
	// CreateSpan logs the start of an event.
	// optText is 0 or 1 strings.
	CreateSpan(event string, optText ...string) Span
}

SpanLogger is something that has the CreateSpan method, which creates a event spanning some duration which will eventually be logged and visualized.

type Span

type Span interface {
	// Done marks a span as done.
	// The err is returned unmodified for convenience at callsites.
	Done(err error) error
}

Span is a handle that can eventually be closed. Typical usage:

sp := sl.CreateSpan("slow_operation")
result, err := doSlowOperation()
sp.Done(err)
// do something with result, err