2019-07-01 21:17:50 +02:00
|
|
|
// Copyright 2019, 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 core
|
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
)
|
|
|
|
|
|
|
|
type TraceID struct {
|
2019-07-03 01:21:24 +02:00
|
|
|
High uint64
|
|
|
|
Low uint64
|
2019-07-01 21:17:50 +02:00
|
|
|
}
|
|
|
|
|
2019-08-02 19:42:47 +02:00
|
|
|
const (
|
|
|
|
traceOptionBitMaskSampled = byte(0x01)
|
|
|
|
traceOptionBitMaskUnused = byte(0xFE)
|
|
|
|
|
|
|
|
// TraceOptionSampled is a byte with sampled bit set. It is a convenient value initialize
|
|
|
|
// SpanContext when a trace is sampled.
|
|
|
|
TraceOptionSampled = traceOptionBitMaskSampled
|
|
|
|
)
|
|
|
|
|
2019-07-01 21:17:50 +02:00
|
|
|
type SpanContext struct {
|
2019-08-02 19:42:47 +02:00
|
|
|
TraceID TraceID
|
|
|
|
SpanID uint64
|
|
|
|
TraceOptions byte
|
2019-07-01 21:17:50 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
var (
|
|
|
|
// INVALID_SPAN_CONTEXT is meant for internal use to return invalid span context during error
|
|
|
|
// conditions.
|
|
|
|
INVALID_SPAN_CONTEXT = SpanContext{}
|
|
|
|
)
|
|
|
|
|
2019-08-05 18:58:51 +02:00
|
|
|
func (sc SpanContext) IsValid() bool {
|
|
|
|
return sc.HasTraceID() && sc.HasSpanID()
|
|
|
|
}
|
|
|
|
|
2019-07-01 21:17:50 +02:00
|
|
|
func (sc SpanContext) HasTraceID() bool {
|
2019-07-03 01:21:24 +02:00
|
|
|
return sc.TraceID.High != 0 || sc.TraceID.Low != 0
|
2019-07-01 21:17:50 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
func (sc SpanContext) HasSpanID() bool {
|
|
|
|
return sc.SpanID != 0
|
|
|
|
}
|
|
|
|
|
|
|
|
func (sc SpanContext) SpanIDString() string {
|
2019-08-02 22:52:55 +02:00
|
|
|
return fmt.Sprintf("%.16x", sc.SpanID)
|
2019-07-01 21:17:50 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
func (sc SpanContext) TraceIDString() string {
|
2019-07-03 01:21:24 +02:00
|
|
|
p1 := fmt.Sprintf("%.16x", sc.TraceID.High)
|
|
|
|
p2 := fmt.Sprintf("%.16x", sc.TraceID.Low)
|
2019-08-02 22:52:55 +02:00
|
|
|
return p1 + p2
|
2019-07-01 21:17:50 +02:00
|
|
|
}
|
2019-08-02 19:42:47 +02:00
|
|
|
|
|
|
|
func (sc SpanContext) IsSampled() bool {
|
|
|
|
return sc.TraceOptions&traceOptionBitMaskSampled == traceOptionBitMaskSampled
|
|
|
|
}
|