tracing

Overview ¶

Package tracing provides functions for starting and stopping our Open Telemetry tracing. This package is intended to be used from main and is simple to use. We offer a few choices on where traces export to. Here is an example to trace to stderr for all requests:

func main() {
	ctx := context.Background()
	// Set us up to always sample. The "trace" package is: "petstore/server/SearchPets/latency"
	tracing.Sampler.Switch(trace.AlwaysSample())
	// Start our tracing and pass the empty Stderr tracing arguments.
	// Stderr{} has no required fields.
	stop, err := tracing.Start(ctx, tracing.Stderr{})
	if err != nil {
		log.Fatalf("problem starting telemetry: %s", err)
	}

	// Stop kills our exporter when main() ends.
	defer stop()
}