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
|
|
|
|
|
|
|
package otel // import "go.opentelemetry.io/otel"
|
|
|
|
|
|
|
|
import (
|
2023-12-18 20:31:00 +00:00
|
|
|
"go.opentelemetry.io/otel/internal/global"
|
2021-08-09 07:19:24 +00:00
|
|
|
)
|
|
|
|
|
2024-08-19 08:01:33 +00:00
|
|
|
// Compile-time check global.ErrDelegator implements ErrorHandler.
|
|
|
|
var _ ErrorHandler = (*global.ErrDelegator)(nil)
|
2021-08-09 07:19:24 +00:00
|
|
|
|
2023-02-01 17:06:36 +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.
|
2023-12-18 20:31:00 +00:00
|
|
|
func GetErrorHandler() ErrorHandler { return global.GetErrorHandler() }
|
2021-08-09 07:19:24 +00:00
|
|
|
|
2023-02-01 17:06:36 +00:00
|
|
|
// 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.
|
2023-12-18 20:31:00 +00:00
|
|
|
func SetErrorHandler(h ErrorHandler) { global.SetErrorHandler(h) }
|
2021-08-09 07:19:24 +00:00
|
|
|
|
2024-08-19 08:01:33 +00:00
|
|
|
// Handle is a convenience function for GetErrorHandler().Handle(err).
|
|
|
|
func Handle(err error) { global.GetErrorHandler().Handle(err) }
|