1// Copyright The OpenTelemetry Authors
 2// SPDX-License-Identifier: Apache-2.0
 3
 4package otel // import "go.opentelemetry.io/otel"
 5
 6import (
 7	"go.opentelemetry.io/otel/internal/global"
 8)
 9
10// Compile-time check global.ErrDelegator implements ErrorHandler.
11var _ 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.
22func 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.
30func SetErrorHandler(h ErrorHandler) { global.SetErrorHandler(h) }
31
32// Handle is a convenience function for GetErrorHandler().Handle(err).
33func Handle(err error) { global.GetErrorHandler().Handle(err) }