[−][src]Enum opentelemetry::trace::SpanKind
trace
only.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 remote child or parent. Span
s with a remote parent are
interesting because they are sources of external load. Span
s 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 Span
s 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 span context for a
remote call.
To summarize the interpretation of these kinds:
SpanKind | Synchronous | Asynchronous | Remote Incoming | Remote Outgoing |
---|---|---|---|---|
Client | yes | yes | ||
Server | yes | yes | ||
Producer | yes | yes | ||
Consumer | yes | yes | ||
Internal |
Variants
Indicates that the span describes a synchronous request to
some remote service. This span is the parent of a remote Server
span and waits for its response.
Indicates that the span covers server-side handling of a
synchronous RPC or other remote request. This span is the child of
a remote Client
span that was expected to wait for a response.
Indicates that the span describes the parent of an
asynchronous request. This parent span is expected to end before
the corresponding child Consumer
span, possibly even before the
child span starts. In messaging scenarios with batching, tracing
individual messages requires a new Producer
span per message to
be created.
Indicates that the span describes the child of an
asynchronous Producer
request.
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
impl Clone for SpanKind
[src]
impl Debug for SpanKind
[src]
impl<'de> Deserialize<'de> for SpanKind
[src]
pub fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
__D: Deserializer<'de>,
[src]
__D: Deserializer<'de>,
impl Display for SpanKind
[src]
impl PartialEq<SpanKind> for SpanKind
[src]
pub fn eq(&self, other: &SpanKind) -> bool
[src]
#[must_use]pub fn ne(&self, other: &Rhs) -> bool
1.0.0[src]
impl Serialize for SpanKind
[src]
pub fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
__S: Serializer,
[src]
__S: Serializer,
impl StructuralPartialEq for SpanKind
[src]
Auto Trait Implementations
impl RefUnwindSafe for SpanKind
[src]
impl Send for SpanKind
[src]
impl Sync for SpanKind
[src]
impl Unpin for SpanKind
[src]
impl UnwindSafe for SpanKind
[src]
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
pub fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> DeserializeOwned for T where
T: for<'de> Deserialize<'de>,
[src]
T: for<'de> Deserialize<'de>,
impl<T> From<T> for T
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T> Instrument for T
[src]
pub fn instrument(self, span: Span) -> Instrumented<Self>
[src]
pub fn in_current_span(self) -> Instrumented<Self>
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> IntoRequest<T> for T
[src]
pub fn into_request(self) -> Request<T>
[src]
impl<T> Same<T> for T
type Output = T
Should always be Self
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn clone_into(&self, target: &mut T)
[src]
impl<T> ToString for T where
T: Display + ?Sized,
[src]
T: Display + ?Sized,
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
pub fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
pub fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<V, T> VZip<V> for T where
V: MultiLane<T>,
V: MultiLane<T>,