trace.go raw

   1  // Copyright The OpenTelemetry Authors
   2  // SPDX-License-Identifier: Apache-2.0
   3  
   4  package otel // import "go.opentelemetry.io/otel"
   5  
   6  import (
   7  	"go.opentelemetry.io/otel/internal/global"
   8  	"go.opentelemetry.io/otel/trace"
   9  )
  10  
  11  // Tracer creates a named tracer that implements Tracer interface.
  12  // If the name is an empty string then provider uses default name.
  13  //
  14  // This is short for GetTracerProvider().Tracer(name, opts...)
  15  func Tracer(name string, opts ...trace.TracerOption) trace.Tracer {
  16  	return GetTracerProvider().Tracer(name, opts...)
  17  }
  18  
  19  // GetTracerProvider returns the registered global trace provider.
  20  // If none is registered then an instance of NoopTracerProvider is returned.
  21  //
  22  // Use the trace provider to create a named tracer. E.g.
  23  //
  24  //	tracer := otel.GetTracerProvider().Tracer("example.com/foo")
  25  //
  26  // or
  27  //
  28  //	tracer := otel.Tracer("example.com/foo")
  29  func GetTracerProvider() trace.TracerProvider {
  30  	return global.TracerProvider()
  31  }
  32  
  33  // SetTracerProvider registers `tp` as the global trace provider.
  34  func SetTracerProvider(tp trace.TracerProvider) {
  35  	global.SetTracerProvider(tp)
  36  }
  37