mirror of
https://github.com/open-telemetry/opentelemetry-go.git
synced 2024-12-14 10:13:10 +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>
71 lines
2.1 KiB
Go
71 lines
2.1 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"
|
|
|
|
apitrace "go.opentelemetry.io/otel/api/trace"
|
|
"go.opentelemetry.io/otel/internal/trace/parent"
|
|
"go.opentelemetry.io/otel/sdk/instrumentation"
|
|
)
|
|
|
|
type tracer struct {
|
|
provider *Provider
|
|
instrumentationLibrary instrumentation.Library
|
|
}
|
|
|
|
var _ apitrace.Tracer = &tracer{}
|
|
|
|
// Start starts a Span and returns it along with a context containing it.
|
|
//
|
|
// The Span is created with the provided name and as a child of any existing
|
|
// span context found in the passed context. The created Span will be
|
|
// configured appropriately by any SpanOption passed. Any Timestamp option
|
|
// passed will be used as the start time of the Span's life-cycle.
|
|
func (tr *tracer) Start(ctx context.Context, name string, options ...apitrace.SpanOption) (context.Context, apitrace.Span) {
|
|
config := apitrace.SpanConfigure(options)
|
|
|
|
parentSpanContext, remoteParent, links := parent.GetSpanContextAndLinks(ctx, config.NewRoot)
|
|
|
|
if p := apitrace.SpanFromContext(ctx); p != nil {
|
|
if sdkSpan, ok := p.(*span); ok {
|
|
sdkSpan.addChild()
|
|
}
|
|
}
|
|
|
|
span := startSpanInternal(tr, name, parentSpanContext, remoteParent, config)
|
|
for _, l := range links {
|
|
span.addLink(l)
|
|
}
|
|
for _, l := range config.Links {
|
|
span.addLink(l)
|
|
}
|
|
span.SetAttributes(config.Attributes...)
|
|
|
|
span.tracer = tr
|
|
|
|
if span.IsRecording() {
|
|
sps, _ := tr.provider.spanProcessors.Load().(spanProcessorMap)
|
|
for sp := range sps {
|
|
sp.OnStart(span.data)
|
|
}
|
|
}
|
|
|
|
ctx, end := startExecutionTracerTask(ctx, name)
|
|
span.executionTracerTaskEnd = end
|
|
return apitrace.ContextWithSpan(ctx, span), span
|
|
}
|