2021-08-09 07:19:24 +00:00
|
|
|
// Copyright The OpenTelemetry Authors
|
2024-08-19 08:01:33 +00:00
|
|
|
// SPDX-License-Identifier: Apache-2.0
|
2021-08-09 07:19:24 +00:00
|
|
|
|
2023-02-01 17:06:36 +00:00
|
|
|
package global // import "go.opentelemetry.io/otel/internal/global"
|
2021-08-09 07:19:24 +00:00
|
|
|
|
|
|
|
import (
|
2023-02-01 17:06:36 +00:00
|
|
|
"errors"
|
2021-08-09 07:19:24 +00:00
|
|
|
"sync"
|
|
|
|
"sync/atomic"
|
|
|
|
|
2023-12-18 20:31:00 +00:00
|
|
|
"go.opentelemetry.io/otel/metric"
|
2021-08-09 07:19:24 +00:00
|
|
|
"go.opentelemetry.io/otel/propagation"
|
|
|
|
"go.opentelemetry.io/otel/trace"
|
|
|
|
)
|
|
|
|
|
|
|
|
type (
|
2024-08-19 08:01:33 +00:00
|
|
|
errorHandlerHolder struct {
|
|
|
|
eh ErrorHandler
|
|
|
|
}
|
|
|
|
|
2021-08-09 07:19:24 +00:00
|
|
|
tracerProviderHolder struct {
|
|
|
|
tp trace.TracerProvider
|
|
|
|
}
|
|
|
|
|
|
|
|
propagatorsHolder struct {
|
|
|
|
tm propagation.TextMapPropagator
|
|
|
|
}
|
2023-12-18 20:31:00 +00:00
|
|
|
|
|
|
|
meterProviderHolder struct {
|
|
|
|
mp metric.MeterProvider
|
|
|
|
}
|
2021-08-09 07:19:24 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
var (
|
2024-08-19 08:01:33 +00:00
|
|
|
globalErrorHandler = defaultErrorHandler()
|
2023-12-18 20:31:00 +00:00
|
|
|
globalTracer = defaultTracerValue()
|
|
|
|
globalPropagators = defaultPropagatorsValue()
|
|
|
|
globalMeterProvider = defaultMeterProvider()
|
2021-08-09 07:19:24 +00:00
|
|
|
|
2024-08-19 08:01:33 +00:00
|
|
|
delegateErrorHandlerOnce sync.Once
|
2021-08-09 07:19:24 +00:00
|
|
|
delegateTraceOnce sync.Once
|
|
|
|
delegateTextMapPropagatorOnce sync.Once
|
2023-12-18 20:31:00 +00:00
|
|
|
delegateMeterOnce sync.Once
|
2021-08-09 07:19:24 +00:00
|
|
|
)
|
|
|
|
|
2024-08-19 08:01:33 +00:00
|
|
|
// GetErrorHandler returns the global ErrorHandler instance.
|
|
|
|
//
|
|
|
|
// The default ErrorHandler instance returned will log all errors to STDERR
|
|
|
|
// until an override ErrorHandler is set with SetErrorHandler. All
|
|
|
|
// ErrorHandler returned prior to this will automatically forward errors to
|
|
|
|
// the set instance instead of logging.
|
|
|
|
//
|
|
|
|
// Subsequent calls to SetErrorHandler after the first will not forward errors
|
|
|
|
// to the new ErrorHandler for prior returned instances.
|
|
|
|
func GetErrorHandler() ErrorHandler {
|
|
|
|
return globalErrorHandler.Load().(errorHandlerHolder).eh
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetErrorHandler sets the global ErrorHandler to h.
|
|
|
|
//
|
|
|
|
// The first time this is called all ErrorHandler previously returned from
|
|
|
|
// GetErrorHandler will send errors to h instead of the default logging
|
|
|
|
// ErrorHandler. Subsequent calls will set the global ErrorHandler, but not
|
|
|
|
// delegate errors to h.
|
|
|
|
func SetErrorHandler(h ErrorHandler) {
|
|
|
|
current := GetErrorHandler()
|
|
|
|
|
|
|
|
if _, cOk := current.(*ErrDelegator); cOk {
|
|
|
|
if _, ehOk := h.(*ErrDelegator); ehOk && current == h {
|
|
|
|
// Do not assign to the delegate of the default ErrDelegator to be
|
|
|
|
// itself.
|
|
|
|
Error(
|
|
|
|
errors.New("no ErrorHandler delegate configured"),
|
|
|
|
"ErrorHandler remains its current value.",
|
|
|
|
)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
delegateErrorHandlerOnce.Do(func() {
|
|
|
|
if def, ok := current.(*ErrDelegator); ok {
|
|
|
|
def.setDelegate(h)
|
|
|
|
}
|
|
|
|
})
|
|
|
|
globalErrorHandler.Store(errorHandlerHolder{eh: h})
|
|
|
|
}
|
|
|
|
|
2021-08-09 07:19:24 +00:00
|
|
|
// TracerProvider is the internal implementation for global.TracerProvider.
|
|
|
|
func TracerProvider() trace.TracerProvider {
|
|
|
|
return globalTracer.Load().(tracerProviderHolder).tp
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetTracerProvider is the internal implementation for global.SetTracerProvider.
|
|
|
|
func SetTracerProvider(tp trace.TracerProvider) {
|
2023-02-01 17:06:36 +00:00
|
|
|
current := TracerProvider()
|
|
|
|
|
|
|
|
if _, cOk := current.(*tracerProvider); cOk {
|
|
|
|
if _, tpOk := tp.(*tracerProvider); tpOk && current == tp {
|
|
|
|
// Do not assign the default delegating TracerProvider to delegate
|
|
|
|
// to itself.
|
|
|
|
Error(
|
|
|
|
errors.New("no delegate configured in tracer provider"),
|
2024-08-19 08:01:33 +00:00
|
|
|
"Setting tracer provider to its current value. No delegate will be configured",
|
2023-02-01 17:06:36 +00:00
|
|
|
)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-08-09 07:19:24 +00:00
|
|
|
delegateTraceOnce.Do(func() {
|
2023-02-01 17:06:36 +00:00
|
|
|
if def, ok := current.(*tracerProvider); ok {
|
2021-08-09 07:19:24 +00:00
|
|
|
def.setDelegate(tp)
|
|
|
|
}
|
|
|
|
})
|
|
|
|
globalTracer.Store(tracerProviderHolder{tp: tp})
|
|
|
|
}
|
|
|
|
|
|
|
|
// TextMapPropagator is the internal implementation for global.TextMapPropagator.
|
|
|
|
func TextMapPropagator() propagation.TextMapPropagator {
|
|
|
|
return globalPropagators.Load().(propagatorsHolder).tm
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetTextMapPropagator is the internal implementation for global.SetTextMapPropagator.
|
|
|
|
func SetTextMapPropagator(p propagation.TextMapPropagator) {
|
2023-02-01 17:06:36 +00:00
|
|
|
current := TextMapPropagator()
|
|
|
|
|
|
|
|
if _, cOk := current.(*textMapPropagator); cOk {
|
|
|
|
if _, pOk := p.(*textMapPropagator); pOk && current == p {
|
|
|
|
// Do not assign the default delegating TextMapPropagator to
|
|
|
|
// delegate to itself.
|
|
|
|
Error(
|
|
|
|
errors.New("no delegate configured in text map propagator"),
|
2024-08-19 08:01:33 +00:00
|
|
|
"Setting text map propagator to its current value. No delegate will be configured",
|
2023-02-01 17:06:36 +00:00
|
|
|
)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-08-09 07:19:24 +00:00
|
|
|
// For the textMapPropagator already returned by TextMapPropagator
|
|
|
|
// delegate to p.
|
|
|
|
delegateTextMapPropagatorOnce.Do(func() {
|
2023-02-01 17:06:36 +00:00
|
|
|
if def, ok := current.(*textMapPropagator); ok {
|
2021-08-09 07:19:24 +00:00
|
|
|
def.SetDelegate(p)
|
|
|
|
}
|
|
|
|
})
|
|
|
|
// Return p when subsequent calls to TextMapPropagator are made.
|
|
|
|
globalPropagators.Store(propagatorsHolder{tm: p})
|
|
|
|
}
|
|
|
|
|
2023-12-18 20:31:00 +00:00
|
|
|
// MeterProvider is the internal implementation for global.MeterProvider.
|
|
|
|
func MeterProvider() metric.MeterProvider {
|
|
|
|
return globalMeterProvider.Load().(meterProviderHolder).mp
|
|
|
|
}
|
|
|
|
|
|
|
|
// SetMeterProvider is the internal implementation for global.SetMeterProvider.
|
|
|
|
func SetMeterProvider(mp metric.MeterProvider) {
|
|
|
|
current := MeterProvider()
|
|
|
|
if _, cOk := current.(*meterProvider); cOk {
|
|
|
|
if _, mpOk := mp.(*meterProvider); mpOk && current == mp {
|
|
|
|
// Do not assign the default delegating MeterProvider to delegate
|
|
|
|
// to itself.
|
|
|
|
Error(
|
|
|
|
errors.New("no delegate configured in meter provider"),
|
2024-08-19 08:01:33 +00:00
|
|
|
"Setting meter provider to its current value. No delegate will be configured",
|
2023-12-18 20:31:00 +00:00
|
|
|
)
|
|
|
|
return
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
delegateMeterOnce.Do(func() {
|
|
|
|
if def, ok := current.(*meterProvider); ok {
|
|
|
|
def.setDelegate(mp)
|
|
|
|
}
|
|
|
|
})
|
|
|
|
globalMeterProvider.Store(meterProviderHolder{mp: mp})
|
|
|
|
}
|
|
|
|
|
2024-08-19 08:01:33 +00:00
|
|
|
func defaultErrorHandler() *atomic.Value {
|
|
|
|
v := &atomic.Value{}
|
|
|
|
v.Store(errorHandlerHolder{eh: &ErrDelegator{}})
|
|
|
|
return v
|
|
|
|
}
|
|
|
|
|
2021-08-09 07:19:24 +00:00
|
|
|
func defaultTracerValue() *atomic.Value {
|
|
|
|
v := &atomic.Value{}
|
|
|
|
v.Store(tracerProviderHolder{tp: &tracerProvider{}})
|
|
|
|
return v
|
|
|
|
}
|
|
|
|
|
|
|
|
func defaultPropagatorsValue() *atomic.Value {
|
|
|
|
v := &atomic.Value{}
|
|
|
|
v.Store(propagatorsHolder{tm: newTextMapPropagator()})
|
|
|
|
return v
|
|
|
|
}
|
2023-12-18 20:31:00 +00:00
|
|
|
|
|
|
|
func defaultMeterProvider() *atomic.Value {
|
|
|
|
v := &atomic.Value{}
|
|
|
|
v.Store(meterProviderHolder{mp: &meterProvider{}})
|
|
|
|
return v
|
|
|
|
}
|