Skip to content

Commit

Permalink
cleanup
Browse files Browse the repository at this point in the history
  • Loading branch information
lmolkova committed Aug 6, 2024
1 parent bfd0265 commit 5fae164
Showing 1 changed file with 8 additions and 11 deletions.
19 changes: 8 additions & 11 deletions specification/trace/api.md
Original file line number Diff line number Diff line change
Expand Up @@ -751,17 +751,14 @@ This functionality MUST be fully implemented in the API, and SHOULD NOT be overr

`SpanKind` clarifies the relationship between Spans that are correlated via
parent/child relationships or span links. `SpanKind` describes two independent
properties that benefit tracing systems during analysis.

The first property described by `SpanKind` reflects whether span describes an
outgoing request to a remote service (CLIENT and PRODUCER spans) or whether
it handles request from an external service (SERVER and CONSUMER spans).

The second property described by `SpanKind` reflects whether a Span represents a
synchronous call. Spans that describe synchronous operations (SERVER and CLIENT),
under ordinary circumstances, end after all its children complete. 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.
properties that benefit tracing systems during analysis:

1. Whether span represents an outgoing request to a remote service (CLIENT and PRODUCER spans)
or a processing of request initiated externally (SERVER and CONSUMER spans).
2. Whether a Span represents a synchronous call. Spans that describe synchronous operations
(SERVER and CLIENT) end after all its children 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
Expand Down

0 comments on commit 5fae164

Please sign in to comment.