mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2024-12-12 10:04:29 +02:00
ec300b28ad
* Update Span API event methods Remove the context argument from the event methods. It is unused and can be added back in as a passed option if needed in the future. Update AddEvent to accept a required name and a set of options. These options are the new EventOption type that can be used to configure a SpanConfig Timestamp and Attributes. Remove the AddEventWithTimestamp method as it is redundant to calling AddEvent with a WithTimestamp option. Update RecordError to also accept the EventOptions. * Add changes to CHANGELOG * Add LifeCycleOption Use the LifeCycleOption to encapsulate the options passed to a span for life cycle events.
85 lines
2.4 KiB
Go
85 lines
2.4 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 otel
|
|
|
|
import (
|
|
"context"
|
|
|
|
"go.opentelemetry.io/otel/codes"
|
|
"go.opentelemetry.io/otel/label"
|
|
)
|
|
|
|
// NewNoopTracerProvider returns an implementation of TracerProvider that
|
|
// performs no operations. The Tracer and Spans created from the returned
|
|
// TracerProvider also perform no operations.
|
|
func NewNoopTracerProvider() TracerProvider {
|
|
return noopTracerProvider{}
|
|
}
|
|
|
|
type noopTracerProvider struct{}
|
|
|
|
var _ TracerProvider = noopTracerProvider{}
|
|
|
|
// Tracer returns noop implementation of Tracer.
|
|
func (p noopTracerProvider) Tracer(string, ...TracerOption) Tracer {
|
|
return noopTracer{}
|
|
}
|
|
|
|
// noopTracer is an implementation of Tracer that preforms no operations.
|
|
type noopTracer struct{}
|
|
|
|
var _ Tracer = noopTracer{}
|
|
|
|
// Start starts a noop span.
|
|
func (t noopTracer) Start(ctx context.Context, name string, _ ...SpanOption) (context.Context, Span) {
|
|
span := noopSpan{}
|
|
return ContextWithSpan(ctx, span), span
|
|
}
|
|
|
|
// noopSpan is an implementation of Span that preforms no operations.
|
|
type noopSpan struct{}
|
|
|
|
var _ noopSpan = noopSpan{}
|
|
|
|
// SpanContext returns an empty span context.
|
|
func (noopSpan) SpanContext() SpanContext { return SpanContext{} }
|
|
|
|
// IsRecording always returns false.
|
|
func (noopSpan) IsRecording() bool { return false }
|
|
|
|
// SetStatus does nothing.
|
|
func (noopSpan) SetStatus(codes.Code, string) {}
|
|
|
|
// SetError does nothing.
|
|
func (noopSpan) SetError(bool) {}
|
|
|
|
// SetAttributes does nothing.
|
|
func (noopSpan) SetAttributes(...label.KeyValue) {}
|
|
|
|
// End does nothing.
|
|
func (noopSpan) End(...SpanOption) {}
|
|
|
|
// RecordError does nothing.
|
|
func (noopSpan) RecordError(error, ...EventOption) {}
|
|
|
|
// Tracer returns the Tracer that created this Span.
|
|
func (noopSpan) Tracer() Tracer { return noopTracer{} }
|
|
|
|
// AddEvent does nothing.
|
|
func (noopSpan) AddEvent(string, ...EventOption) {}
|
|
|
|
// SetName does nothing.
|
|
func (noopSpan) SetName(string) {}
|