handler.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  )
   9  
  10  // Compile-time check global.ErrDelegator implements ErrorHandler.
  11  var _ ErrorHandler = (*global.ErrDelegator)(nil)
  12  
  13  // GetErrorHandler returns the global ErrorHandler instance.
  14  //
  15  // The default ErrorHandler instance returned will log all errors to STDERR
  16  // until an override ErrorHandler is set with SetErrorHandler. All
  17  // ErrorHandler returned prior to this will automatically forward errors to
  18  // the set instance instead of logging.
  19  //
  20  // Subsequent calls to SetErrorHandler after the first will not forward errors
  21  // to the new ErrorHandler for prior returned instances.
  22  func GetErrorHandler() ErrorHandler { return global.GetErrorHandler() }
  23  
  24  // SetErrorHandler sets the global ErrorHandler to h.
  25  //
  26  // The first time this is called all ErrorHandler previously returned from
  27  // GetErrorHandler will send errors to h instead of the default logging
  28  // ErrorHandler. Subsequent calls will set the global ErrorHandler, but not
  29  // delegate errors to h.
  30  func SetErrorHandler(h ErrorHandler) { global.SetErrorHandler(h) }
  31  
  32  // Handle is a convenience function for GetErrorHandler().Handle(err).
  33  func Handle(err error) { global.GetErrorHandler().Handle(err) }
  34