Specificationv1.59.0
since v1.58.02 breaking4 notable41 editorial
From the upstream release notes
- Clarify that environment variable propagation operational guidance is
- Clean up implementation guidelines for environment variable propagation
- Remove caching behavior suggestions for environment variable propagation
- Mark "Environment Variables as Context Propagation Carriers" as Release
- Amend the description of Composite/Composable samplers.
- Add ETW (Event Tracing for Windows) example mapping to the logs data
- Add Profiles data model (data-model.md).
- Add non-normative supplementary guidelines for SDK self-observability.
- Add OTEP proposing a central OpenTelemetry benchmarks repository.
- Introduce Policies into the specification.
Breaking2
Requirements added to, removed from, or restrengthened in a document marked Stable.
- rule droppedrequirementcontext/env-carriers.md#process-spawningMUST NOT removed: The language implementations MUST NOT handle spawning processes.
- new rulerequirementcontext/env-carriers.md#propagator-mechanismsMUST NOT added: Language implementations MUST NOT spawn child processes as part of environment variable context propagation.
Notable4
- stabilitydocumentcontext/env-carriers.mdStatus changed from Beta to Release Candidate.
- stabilitydocumentprofiles/data-format.mdStatus changed from Development to Alpha.
- new rulerequirementcontext/env-carriers.md#propagator-mechanismsSHOULD added: Language implementations SHOULD document operational guidance, including initialization-time extraction, child process environment handling, and security considerations.
- new rulerequirementtrace/sdk.md#getsamplingintentSHOULD added: The calling CompositeSampler SHOULD update the threshold of the outgoing TraceState, as described above.
Editorial41
- removedsectioncontext/env-carriers.md#supplementary-guidelinesSection "Supplementary Guidelines" removed.
- rule droppedrequirementcontext/env-carriers.md#environment-variable-immutabilitySHOULD removed: Once set for a process, environment variables SHOULD be treated as immutable within that process:
- rule droppedrequirementcontext/env-carriers.md#environment-variable-immutabilitySHOULD removed: Applications SHOULD read context-related environment variables during initialization.
- rule droppedrequirementcontext/env-carriers.md#environment-variable-immutabilitySHOULD NOT removed: Applications SHOULD NOT modify context-related environment variables of the environment in which the parent process exists.
- rule droppedrequirementcontext/env-carriers.md#process-spawningSHOULD removed: Parent processes SHOULD copy the current environment variables (if applicable), modify, and inject context when spawning child processes.
- rule droppedrequirementcontext/env-carriers.md#process-spawningSHOULD removed: Child processes SHOULD extract context from environment variables at startup.
- rule droppedrequirementcontext/env-carriers.md#process-spawningSHOULD removed: When spawning multiple child processes with different contexts or baggage, each child SHOULD receive its own copy of the environment variables with appropriate information.
- rule droppedrequirementcontext/env-carriers.md#securitySHOULD NOT removed: Implementations SHOULD NOT store sensitive information in environment variables.
- rule droppedrequirementcontext/env-carriers.md#securitySHOULD removed: Applications running in multi-tenant environments SHOULD be aware that environment variables may be visible to other processes or users with appropriate permissions.
- rewordedrequirementtrace/sdk.md#getsamplingintentMUST reworded: The explicit randomness values MUST not be modified.
- addedsectioncontext/env-carriers.md#implementation-guidelinesNew section "Implementation Guidelines".
- addedsectionlogs/data-model-appendix.md#etw-event-tracing-for-windowsNew section "ETW (Event Tracing for Windows)".
- addedsectionprofiles/data-format.md#attributesNew section "Attributes".
- addedsectionprofiles/data-format.md#cpu-profile-with-resource-attributes-and-span-linkNew section "CPU profile with resource attributes and span link".
- addedsectionprofiles/data-format.md#dictionaryNew section "Dictionary".
- addedsectionprofiles/data-format.md#dictionary-use-in-keyvalueNew section "Dictionary use in
KeyValue". - addedsectionprofiles/data-format.md#example-payloadsNew section "Example payloads".
- addedsectionprofiles/data-format.md#from-other-signals-to-profilesNew section "From other signals to profiles".
- addedsectionprofiles/data-format.md#from-profiles-to-other-signalsNew section "From profiles to other signals".
- addedsectionprofiles/data-format.md#message-descriptionsNew section "Message descriptions".
- addedsectionprofiles/data-format.md#message-embeddingNew section "Message embedding".
- addedsectionprofiles/data-format.md#message-functionNew section "Message
Function". - addedsectionprofiles/data-format.md#message-keyvalueandunitNew section "Message
KeyValueAndUnit". - addedsectionprofiles/data-format.md#message-lineNew section "Message
Line". - addedsectionprofiles/data-format.md#message-linkNew section "Message
Link". - addedsectionprofiles/data-format.md#message-locationNew section "Message
Location". - addedsectionprofiles/data-format.md#message-mappingNew section "Message
Mapping". - addedsectionprofiles/data-format.md#message-profileNew section "Message
Profile". - addedsectionprofiles/data-format.md#message-profilesdataNew section "Message
ProfilesData". - addedsectionprofiles/data-format.md#message-profilesdictionaryNew section "Message
ProfilesDictionary". - addedsectionprofiles/data-format.md#message-resourceprofilesNew section "Message
ResourceProfiles". - addedsectionprofiles/data-format.md#message-sampleNew section "Message
Sample". - addedsectionprofiles/data-format.md#message-scopeprofilesNew section "Message
ScopeProfiles". - addedsectionprofiles/data-format.md#message-stackNew section "Message
Stack". - addedsectionprofiles/data-format.md#message-valuetypeNew section "Message
ValueType". - addedsectionprofiles/data-format.md#notable-differences-compared-to-other-signalsNew section "Notable differences compared to other signals".
- addedsectionprofiles/data-format.md#overviewNew section "Overview".
- addedsectionprofiles/data-format.md#referencesNew section "References".
- addedsectionprofiles/data-format.md#relationships-with-other-signalsNew section "Relationships with other signals".
- addedsectionprofiles/data-format.md#simple-cpu-profileNew section "Simple CPU profile".
- rewrittensectiontrace/sdk.md#compositesampler"CompositeSampler" substantially rewritten (398 to 2075 characters).