matrix

open-telemetry · Jul 26, 2024 · f0297fe · f0297fe
1 parent bdda5bb
commit f0297fe
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 3 deletions.
diff --git 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
@@ -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