Enum opentelemetry::trace::SpanKind

source ·
pub enum SpanKind {
    Client,
    Server,
    Producer,
    Consumer,
    Internal,
}
Available on crate feature trace only.
Expand description

SpanKind describes the relationship between the Span, its parents, and its children in a trace.

SpanKind describes two independent properties that benefit tracing systems during analysis:

The first property described by SpanKind reflects whether the span is a “logical” remote child or parent. By “logical”, we mean that the span is logically a remote child or parent, from the point of view of the library that is being instrumented. Spans with a remote parent are interesting because they are sources of external load. Spans with a remote child are interesting because they reflect a non-local system dependency.

The second property described by SpanKind reflects whether a child span represents a synchronous call. When a child span is synchronous, the parent is expected to wait for it to complete under ordinary circumstances. It can be useful for tracing systems to know this property, since synchronous spans may contribute to the overall trace latency. Asynchronous scenarios can be remote or local.

In order for SpanKind to be meaningful, callers should arrange that a single span does not serve more than one purpose. For example, a server-side span should not be used directly as the parent of another remote span. As a simple guideline, instrumentation should create a new span prior to extracting and serializing the SpanContext for a remote call.

Note: there are complex scenarios where a SpanKind::Client span may have a child that is also logically a SpanKind::Client span, or a SpanKind::Producer span might have a local child that is a SpanKind::Client span, depending on how the various libraries that are providing the functionality are built and instrumented. These scenarios, when they occur, should be detailed in the semantic conventions appropriate to the relevant libraries.

To summarize the interpretation of these kinds:

SpanKindSynchronousAsynchronousRemote IncomingRemote Outgoing
Clientyesyes
Serveryesyes
Produceryesmaybe
Consumeryesmaybe
Internal

Variants§

§

Client

Indicates that the span describes a request to some remote service. This span is usually the parent of a remote SpanKind::Server span and does not end until the response is received.

§

Server

Indicates that the span covers server-side handling of a synchronous RPC or other remote request. This span is often the child of a remote SpanKind::Client span that was expected to wait for a response.

§

Producer

Indicates that the span describes the initiators of an asynchronous request. This parent span will often end before the corresponding child SpanKind::Consumer span, possibly even before the child span starts.

In messaging scenarios with batching, tracing individual messages requires a new SpanKind::Producer span per message to be created.

§

Consumer

Indicates that the span describes a child of an asynchronous SpanKind::Producer request.

§

Internal

Default value.

Indicates that the span represents an internal operation within an application, as opposed to an operations with remote parents or children.

Trait Implementations§

source§

impl Clone for SpanKind

source§

fn clone(&self) -> SpanKind

Returns a copy of the value. Read more
1.0.0 · source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
source§

impl Debug for SpanKind

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl PartialEq for SpanKind

source§

fn eq(&self, other: &SpanKind) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Eq for SpanKind

source§

impl StructuralPartialEq for SpanKind

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T> FutureExt for T

source§

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Available on crate feature trace only.
Attaches the provided Context to this type, returning a WithContext wrapper. Read more
source§

fn with_current_context(self) -> WithContext<Self>

Available on crate feature trace only.
Attaches the current Context to this type, returning a WithContext wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.