Class Tracer¶
Defined in File tracer.h
Inheritance Relationships¶
Derived Types¶
public opentelemetry::trace::DefaultTracer
(Class DefaultTracer)public opentelemetry::trace::NoopTracer
(Class NoopTracer)
Class Documentation¶
-
class
opentelemetry::trace
::
Tracer
¶ Handles span creation and in-process context propagation.
This class provides methods for manipulating the context, creating spans, and controlling spans’ lifecycles.
Subclassed by opentelemetry::trace::DefaultTracer, opentelemetry::trace::NoopTracer
Public Functions
-
virtual
~Tracer
() = default¶
-
virtual nostd::shared_ptr<Span>
StartSpan
(nostd::string_view name, const common::KeyValueIterable &attributes, const SpanContextKeyValueIterable &links, const StartSpanOptions &options = {}) noexcept = 0¶ Starts a span.
Optionally sets attributes at Span creation from the given key/value pairs.
Attributes will be processed in order, previous attributes with the same key will be overwritten.
-
inline nostd::shared_ptr<Span>
StartSpan
(nostd::string_view name, const StartSpanOptions &options = {}) noexcept¶
-
inline nostd::shared_ptr<Span>
StartSpan
(nostd::string_view name, const common::KeyValueIterable &attributes, const StartSpanOptions &options = {}) noexcept¶
-
inline nostd::shared_ptr<Span>
StartSpan
(nostd::string_view name, std::initializer_list<std::pair<nostd::string_view, common::AttributeValue>> attributes, const StartSpanOptions &options = {}) noexcept¶
-
inline nostd::shared_ptr<Span>
StartSpan
(nostd::string_view name, std::initializer_list<std::pair<nostd::string_view, common::AttributeValue>> attributes, std::initializer_list<std::pair<SpanContext, std::initializer_list<std::pair<nostd::string_view, common::AttributeValue>>>> links, const StartSpanOptions &options = {}) noexcept¶
Set the active span. The span will remain active until the returned Scope object is destroyed.
- Parameters
span – the span that should be set as the new active span.
- Returns
a Scope that controls how long the span will be active.
-
inline nostd::shared_ptr<Span>
GetCurrentSpan
() noexcept¶ Get the currently active span.
- Returns
the currently active span, or an invalid default span if no span is active.
-
template<class
Rep
, classPeriod
>
inline voidForceFlush
(std::chrono::duration<Rep, Period> timeout) noexcept¶ Force any buffered spans to flush.
- Parameters
timeout – to complete the flush
-
virtual void
ForceFlushWithMicroseconds
(uint64_t timeout) noexcept = 0¶
-
template<class
Rep
, classPeriod
>
inline voidClose
(std::chrono::duration<Rep, Period> timeout) noexcept¶ ForceFlush any buffered spans and stop reporting spans.
- Parameters
timeout – to complete the flush
-
virtual void
CloseWithMicroseconds
(uint64_t timeout) noexcept = 0¶
-
virtual