open-telemetry
/
opentelemetry.io
mirror of https://github.com/open-telemetry/opentelemetry.io.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify context in tracing page (#2891)

This commit is contained in:
Phillip Carter 2023-06-20 07:16:22 -07:00 committed by GitHub
parent e60fde0a44
commit cafd352998
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 14 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
content/en/docs/concepts/signals/traces.md
View File

@ -143,19 +143,22 @@ A **Context** is an object that contains the information for the sending and
receiving service to correlate one span with another and associate it with the receiving service to correlate one span with another and associate it with the
trace overall. For example, if Service A calls Service B, then a span from trace overall. For example, if Service A calls Service B, then a span from
Service A whose ID is in context will be used as the parent span for the next Service A whose ID is in context will be used as the parent span for the next
span created in Service B. span created in Service B. The trace ID that is in context will be used for the
next span created in Service B as well, which signifies that the span is part of
the same trace as the span from Service A.
**Propagation** is the mechanism that moves Context between services and **Propagation** is the mechanism that moves context between services and
processes. By doing so, it assembles a Distributed Trace. It serializes or processes. It serializes or deserializes the context object and provides the
deserializes Span Context and provides the relevant Trace information to be relevant Trace information to be propagated from one service to another.
propagated from one service to another. We now have what we call: **Trace Propagation is usually handled by instrumentation libraries and is transparent
Context**. to the user, but in the event that you need to manually propagate context, you
can use Propagation APIs.
Context is an abstract concept - it requires a concrete implementation to OpenTelemetry supports several different context formats. The default format
actually be useful. OpenTelemetry supports several different Context formats. used in OpenTelemetry tracing is called
The default format used in OpenTelemetry tracing is W3C `TraceContext`. Each [W3C TraceContext](https://www.w3.org/TR/trace-context/). Each context object is
Context object is associated with a span and can be accessed specification on stored in a span. See [Span Context](#span-context) for details on the context
spans. See [Span Context](#span-context). object and what other information is available..
By combining Context and Propagation, you now can assemble a Trace. By combining Context and Propagation, you now can assemble a Trace.