From f0297fe08300ccf8ab89aa8f410cbb798c89ccbb Mon Sep 17 00:00:00 2001 From: Joshua MacDonald Date: Fri, 26 Jul 2024 08:49:00 -0700 Subject: [PATCH] matrix --- spec-compliance-matrix.md | 2 ++ specification/trace/sdk.md | 6 +++--- 2 files changed, 5 insertions(+), 3 deletions(-) diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md index b0d9f5c07ef..42e39dafffe 100644 --- a/spec-compliance-matrix.md +++ b/spec-compliance-matrix.md @@ -86,6 +86,8 @@ formats is required. Implementing more than one format is optional. | [Built-in `SpanProcessor`s implement `ForceFlush` spec](specification/trace/sdk.md#forceflush-1) | | | + | | + | + | + | + | + | + | + | | | [Attribute Limits](specification/common/README.md#attribute-limits) | X | | + | | + | + | + | + | | | | | | Fetch InstrumentationScope from ReadableSpan | | | + | | + | | | + | | | | | +| TraceID generator implements W3C Trace Context Level 2 randomness | | | | | | | | | | | | | +| OpenTelemetry explicit randomness supported | X | | | | | | | | | | | | ## Baggage diff --git a/specification/trace/sdk.md b/specification/trace/sdk.md index 6bed8450cbd..991b09b28e1 100644 --- a/specification/trace/sdk.md +++ b/specification/trace/sdk.md @@ -481,11 +481,11 @@ The following configuration properties should be available when creating the sam ### Sampling Requirements -The [W3C Trace Context Level 2][W3CCONTEXTMAIN] Candidate Recommendation introduced [a Random trace flag][W3CCONTEXTRANDOMFLAG] for indicating that the TraceID contains 56 random bits specified for statistical purposes. This flag indicates that [the least-significant ("rightmost") 7 bytes or 56 bits of the TraceID are random][W3CCONTEXTTRACEID]. +The [W3C Trace Context Level 2][W3CCONTEXTMAIN] Candidate Recommendation includes [a Random trace flag][W3CCONTEXTRANDOMFLAG] for indicating that the TraceID contains 56 random bits, specified for statistical purposes. This flag indicates that [the least-significant ("rightmost") 7 bytes or 56 bits of the TraceID are random][W3CCONTEXTTRACEID]. -Note the Random flag does not propagate through [Trace Context Level 1][W3CCONTEXTLEVEL1] implementations, which do not recognize the flag. Therefore, this flag is considered meaningful only when it is set on a root span context. To enable sampling in this and other situations where TraceIDs lack sufficient randomness, OpenTelemetry defines an [optional randomness value][OTELRVALUE] encoded in the [W3C TraceState field][W3CCONTEXTTRACESTATE]. +Note the Random flag does not propagate through [Trace Context Level 1][W3CCONTEXTLEVEL1] implementations, which do not recognize the flag. Therefore, this flag is considered meaningful only when it is set on a root span context. To enable sampling in this and other situations where TraceIDs lack sufficient randomness, OpenTelemetry defines an optional [explicit randomness value][OTELRVALUE] encoded in the [W3C TraceState field][W3CCONTEXTTRACESTATE]. -The specification of recommends the use of either TraceID randomness or explicit trace randomness, which ensures that samplers always have sufficient randomness when W3C Trace Context propagation is used. +This specification recommends the use of either TraceID randomness or explicit trace randomness, which ensures that samplers always have sufficient randomness when using W3C Trace Context propagation. [W3CCONTEXTMAIN]: https://www.w3.org/TR/trace-context-2 [W3CCONTEXTLEVEL1]: https://www.w3.org/TR/trace-context