package trace
import "go.opentelemetry.io/otel/sdk/export/trace"
Index ¶
Types ¶
type Event ¶
type Event struct {
// Name is the name of this event
Name string
// Attributes describe the aspects of the event.
Attributes []label.KeyValue
// Time is the time at which this event was recorded.
Time time.Time
}
Event is thing that happened during a Span's lifetime.
type SpanData ¶
type SpanData struct {
SpanContext trace.SpanContext
ParentSpanID trace.SpanID
SpanKind trace.SpanKind
Name string
StartTime time.Time
// The wall clock time of EndTime will be adjusted to always be offset
// from StartTime by the duration of the span.
EndTime time.Time
Attributes []label.KeyValue
MessageEvents []Event
Links []trace.Link
StatusCode codes.Code
StatusMessage string
HasRemoteParent bool
DroppedAttributeCount int
DroppedMessageEventCount int
DroppedLinkCount int
// ChildSpanCount holds the number of child span created for this span.
ChildSpanCount int
// Resource contains attributes representing an entity that produced this span.
Resource *resource.Resource
// InstrumentationLibrary defines the instrumentation library used to
// provide instrumentation.
InstrumentationLibrary instrumentation.Library
}
SpanData contains all the information collected by a completed span.
type SpanExporter ¶
type SpanExporter interface {
// ExportSpans exports a batch of SpanData.
//
// This function is called synchronously, so there is no concurrency
// safety requirement. However, due to the synchronous calling pattern,
// it is critical that all timeouts and cancellations contained in the
// passed context must be honored.
//
// Any retry logic must be contained in this function. The SDK that
// calls this function will not implement any retry logic. All errors
// returned by this function are considered unrecoverable and will be
// reported to a configured error Handler.
ExportSpans(ctx context.Context, spanData []*SpanData) error
// Shutdown notifies the exporter of a pending halt to operations. The
// exporter is expected to preform any cleanup or synchronization it
// requires while honoring all timeouts and cancellations contained in
// the passed context.
Shutdown(ctx context.Context) error
}
SpanExporter handles the delivery of SpanData to external receivers. This is the final component in the trace export pipeline.
Source Files ¶
trace.go
Directories ¶
| Path | Synopsis |
|---|---|
| export/trace/tracetest | tracetest is a testing helper package for the SDK. |
- Version
- v0.14.0
- Published
- Nov 20, 2020
- Platform
- js/wasm
- Imports
- 7 packages
- Last checked
- 2 weeks ago –
Tools for package owners.