mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2025-02-07 13:31:42 +02:00
d143b8fbf8
* Unify API Span Start/End Options Replace both with `SpanOption`. Add a unified `SpanConfig` to match and a `SpanConfigure` function to parse a `SpanConfig` from `SpanOption`s. Update all the related options to use new `SpanOption`s. * No non-zero SpanConfig defaults The SDK uses an internal clock for the current time that cannot be use if it does not know the time has not been set. * Append attributes for WithAttributes This preserves existing behavior. * Add unit test for SpanConfigure * Propagate changes * Update append option documentation * Update testing comments * Move comments on guarantees to appropriate function * Add documentation for SDK methods Include SDK implementation specific information in the Tracer Start method and Span End method. * Add changes to Changelog * Apply suggestions from code review Co-authored-by: ET <evantorrie@users.noreply.github.com> * Update the SpanKind comment in the SpanConfig Try for a less tautological comment. Co-authored-by: ET <evantorrie@users.noreply.github.com>
80 lines
1.9 KiB
Go
80 lines
1.9 KiB
Go
// Copyright The OpenTelemetry Authors
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package trace
|
|
|
|
import (
|
|
"context"
|
|
"time"
|
|
|
|
"go.opentelemetry.io/otel/codes"
|
|
"go.opentelemetry.io/otel/label"
|
|
)
|
|
|
|
type NoopSpan struct {
|
|
}
|
|
|
|
var _ Span = (*NoopSpan)(nil)
|
|
|
|
// SpanContext returns an invalid span context.
|
|
func (NoopSpan) SpanContext() SpanContext {
|
|
return EmptySpanContext()
|
|
}
|
|
|
|
// IsRecording always returns false for NoopSpan.
|
|
func (NoopSpan) IsRecording() bool {
|
|
return false
|
|
}
|
|
|
|
// SetStatus does nothing.
|
|
func (NoopSpan) SetStatus(status codes.Code, msg string) {
|
|
}
|
|
|
|
// SetError does nothing.
|
|
func (NoopSpan) SetError(v bool) {
|
|
}
|
|
|
|
// SetAttributes does nothing.
|
|
func (NoopSpan) SetAttributes(attributes ...label.KeyValue) {
|
|
}
|
|
|
|
// SetAttribute does nothing.
|
|
func (NoopSpan) SetAttribute(k string, v interface{}) {
|
|
}
|
|
|
|
// End does nothing.
|
|
func (NoopSpan) End(options ...SpanOption) {
|
|
}
|
|
|
|
// RecordError does nothing.
|
|
func (NoopSpan) RecordError(ctx context.Context, err error, opts ...ErrorOption) {
|
|
}
|
|
|
|
// Tracer returns noop implementation of Tracer.
|
|
func (NoopSpan) Tracer() Tracer {
|
|
return NoopTracer{}
|
|
}
|
|
|
|
// AddEvent does nothing.
|
|
func (NoopSpan) AddEvent(ctx context.Context, name string, attrs ...label.KeyValue) {
|
|
}
|
|
|
|
// AddEventWithTimestamp does nothing.
|
|
func (NoopSpan) AddEventWithTimestamp(ctx context.Context, timestamp time.Time, name string, attrs ...label.KeyValue) {
|
|
}
|
|
|
|
// SetName does nothing.
|
|
func (NoopSpan) SetName(name string) {
|
|
}
|