Releases: open-telemetry/opentelemetry-specification
Releases · open-telemetry/opentelemetry-specification
Release 1.28.0
v1.28.0 (2023-12-07)
Context
- No changes.
Traces
- Stabilize how exceptions are recorded using the Trace SDK.
(#3769) - Add definition for standard output span exporter.
(#3740)
Metrics
- Add optional configuration for Prometheus exporters to promote resource attributes to metric attributes
(#3761) - Clarifications and flexibility in Exemplar speicification.
(#3760)
Logs
- Add definition for standard output log record exporter.
(#3741) - BREAKING: Change
event.name
definition to includenamespace
and removedevent.domain
from log event attributes.
(#3749) - BREAKING: Refine the arguments of the emit Event API. Instead of accepting a
LogRecord
, the individual arguments are enumerated along with the implementation requirements on how those arguments map toLogRecord
.
(#3772)
Resource
- No changes.
OpenTelemetry Protocol
- Clarify HTTP endpoint configuration option handling.
(#3739)
Compatibility
- No changes.
SDK Configuration
- Add
console
as an exporter type that is supported via environment variable configuration.
(#3742)
Common
- No changes.
Supplementary Guidelines
- No changes.
New Contributors
- @patrickhousley made their first contribution in #3749
- @davix made their first contribution in #3764
Release 1.27.0
v1.27.0 (2023-11-08)
Context
- No changes.
Traces
- Add a new AddLink() operation to Span (experimental). (#3678)
Metrics
- No changes.
Logs
- No changes.
Resource
- No changes.
OpenTelemetry Protocol
- New exporter implementations do not need to support
OTEL_EXPORTER_OTLP_SPAN_INSECURE
andOTEL_EXPORTER_OTLP_METRIC_INSECURE
. (#3719)
Compatibility
- No changes.
SDK Configuration
- Define file configuration parse and create operations. (#3437)
- Add environment variable implementation guidelines. (#3738)
Common
- Rename/replace
(client|server).socket.(address|port)
attributes withnetwork.(peer|local).(address|port)
. (#3713)
Supplementary Guidelines
- No changes.
New Contributors
Release 1.26.0
v1.26.0 (2023-10-10)
Context
- No changes.
Traces
ParentBased
sampler is a decorator (not a composite). (#3706)
Metrics
- Consistently use "advisory parameters" instead of "advice parameters". (#3693)
- Stabilize
ExplicitBucketBoundaries
instrument advisory parameter. (#3694)
Logs
- Update two apache access logs mappings. (#3712)
Resource
- No changes.
OpenTelemetry Protocol
- No changes.
Compatibility
- Prometheus exporters omit empty resources and scopes without attributes. (#3660)
SDK Configuration
- Fix description of OTEL_ATTRIBUTE_COUNT_LIMIT (#3714)
Common
- Add upgrading and version management documentation (#3695)
Supplementary Guidelines
- No changes.
New Contributors
- @albertored made their first contribution in #3693
- @jjatria made their first contribution in #3714
Release v1.25.0
v1.25.0 (2023-09-13)
Context
- No changes.
Traces
- No changes.
Metrics
- Increase metric name maximum length from 63 to 255 characters.
(#3648) - MetricReader.Collect ignores Resource from MetricProducer.Produce.
(#3636) - Attribute sets not observed during async callbacks are not exported.
(#3242) - Promote MetricProducer specification to feature-freeze.
(#3655) - Add synchronous gauge instrument, clarify temporality selection influence on
metric point persistence.
(#3540) - Clarify that advice is non-identifying.
(#3661) - Define the default size of the
SimpleFixedSizeExemplarReservoir
to be1
.
(#3670) - Rename "advice" to "advisory parameters".
(#3662) - Clarify the minimal implementation of a
View
'sattribute_keys
is an allow-list.
(#3680) - Add "/" to valid characters for instrument names
(#3684) - Stabilize the
MetricProducer
.
(#3685)
Logs
- Update GCP data model to use
TraceFlags
instead of
gcp.trace_sampled
. (#3629)
Resource
- No changes.
OpenTelemetry Protocol
- Fix and clarify definition of "transient error" in the OTLP exporter specification.
(#3653)
Compatibility
- OpenTracing Shim: Allow invalid but sampled SpanContext to be returned.
(#3471) - Prometheus: Allow changing metric names by default when translating from Prometheus to OpenTelemetry.
(#3679)
SDK Configuration
- No changes.
Common
- No changes.
Supplementary Guidelines
- No changes.
Full Changelog: v1.24.0...v1.25.0
Release v1.24.0
v1.24.0 (2023-08-10)
Context
- No changes.
Traces
- No changes.
Metrics
- Specify how to handle instrument name conflicts.
(#3626) - Add experimental metric attributes advice API.
(#3546) - Revise the exemplar default reservoirs.
(#3627) - Mark the default aggregation cardinality Experimental in MetricReader.
(#3619) - Mark Metric No-Op API as stable.
(#3642) - MetricProducers are provided as config to MetricReaders instead of through a RegisterProducer operation.
(#3613) - Refine
MetricProvider.ForceFlush
and defineForceFlush
for periodic exporting MetricReader.
(#3563)
Logs
- Clarify how log appender use Scope name and attributes.
(#3583) - Mark No-Op Logs Bridge API as stable.
(#3642)
Resource
- No changes.
Compatibility
- Prometheus exporters SHOULD provide configuration to disable the addition of
_total
suffixes.
(#3590)
SDK Configuration
- No changes.
Common
- No changes.
Supplementary Guidelines
- No changes.
New Contributors
- @PerfectSlayer made their first contribution in #3633
Full Changelog: v1.23.0...v1.24.0
Release v1.23.0
v1.23.0 (2023-07-12)
Context
- No changes.
Traces
- Refine SDK TracerProvider configuration section.
(#3559) - Make SDK Tracer Creation more normative.
(#3529)
Metrics
- Refine SDK MeterProvider configuration section.
(#3522) - Clarify metric view requirements and recommendations.
(#3524) - Change the view name to be the view's stream configuration name.
(#3524) - Make SDK Meter Creation more normative.
(#3529) - Clarify duplicate instrument registration scope to be a MeterProvider.
(#3538) - Clarify identical instrument definition for SDK.
(#3585)
Logs
- Refine SDK LoggerProvider configuration section.
(#3559) - Make SDK Logger Creation more normative.
(#3529)
Resource
- No changes.
Compatibility
- NOTICE: Remove the Jaeger Exporter
(#3567) - Prometheus: Do not add
_total
suffix if the metric already ends in_total
.
(#3581) - Prometheus type and unit suffixes are not trimmed by default.
(#3580)
SDK Configuration
- Extract Exemplar section and mark it as Experimental.
(#3533)
Common
- No changes.
Supplemenatary Guidelines
- No changes.
New Contributors
Release v1.22.0
Release v1.22.0 (2023-06-09)
Context
- No changes.
Traces
- No changes.
Metrics
- Make recommendation to reserve aggregator normative.
(#3526)
Logs
- No changes.
Resource
- No changes.
Compatibility
- No changes.
OpenTelemetry Protocol
- Move OTLP specification to github.com/open-telemetry/opentelemetry-proto.
(#3454)
SDK Configuration
- Extract Examplar section and mark it as Experimental.
(#3533)
Telemetry Schemas
- No changes.
Common
- Explain why custom attributes are not recommended to be placed in OTel
namespaces.
(#3507)
Supplementary Guidelines
- No changes.
New Contributors
- @zeitlinger made their first contribution in #3542
Release v1.21.0
v1.21.0 (2023-05-17)
Context
- No changes.
Traces
- No changes.
Metrics
- Add experimental histogram advice API.
(#3216) - Recommended non-prefixed units for metric instrument semantic conventions.
(#3312) - Recommended cardinality limits to protect metrics pipelines against
excessive data production from a single instrument.
(#2960) - Add links to the JMX APIs that are the JVM runtime metric sources.
(#3463)
Logs
- Clarify parameters for emitting a log record.
(#3345) - Drop logger include_trace_context parameter.
(#3397) - Clarify how ObservedTimestamp field is set if unspecified
(#3385) - Mark logs bridge API / SDK as stable.
(#3376) - Mark LogRecord Environment Variables as stable.
(#3449)
Resource
- No changes.
Semantic Conventions
- The Semantic Conventions have moved to a separate repository
github.com/open-telemetry/semantic-conventions.
There will be no future semantic conventions release from this repository.
(#3489)
Compatibility
- Mark OpenCensus compatibility spec as stable
(#3425)
OpenTelemetry Protocol
- No changes.
SDK Configuration
- Lay initial groundwork for file configuration
(#3360) - Move file configuration schema to
opentelemetry-configuration
.
(#3412) - Move
sdk-configuration.md
andsdk-environment-variables.md
to/specification/configuration/
.
(#3434)
Telemetry Schemas
- No changes.
Common
- Add log entries to specification README.md contents.
(#3435)
Supplementary Guidelines
- Add guidance to use service-supported propagation formats as default for AWS SDK client calls.
(#3212)
New Contributors
- @sebastien-rosset made their first contribution in #3194
- @roberttoyonaga made their first contribution in #3463
- @lzchen made their first contribution in #3475
Full Changelog: v1.20.0...v1.21.0
Release v1.20.0
v1.20.0 (2023-04-07)
Context
- No changes.
Traces
- Clarify required parent information in ReadableSpan. Technically a relaxation,
but previously it was easy to overlook certain properties were required.
(#3257) - Remove underspecified and unused Span decorator from Trace SDK.
(#3363)
Metrics
- Clarify that units should use UCUM case sensitive variant.
(#3306) - Remove No-Op instrument and Meter creation requirements.
(#3322)
Logs
- Update log readme "request context" to "trace context".
(#3332) - Remove log readme document status.
(#3334) - Break out compatibility document on recording trace context in non-OTLP Log Format
(#3331) - Ensure Logs Bridge API doesn't contain SDK implementation details
(#3275) - Add Log Bridge API artifact naming guidance
(#3346) - Add log appender / bridge to glossary.
(#3335)
Resource
- No changes.
Semantic Conventions
- Clarify that attribute requirement levels apply to the instrumentation library
(#3289) - Fix grammatical number of metric units.
(#3298) - Rename
net.app.protocol.(name|version)
tonet.protocol.(name|version)
(#3272) - Replace
http.flavor
withnet.protocol.(name|version)
(#3272) - Metric requirement levels are now stable
(#3271) - BREAKING: remove
messaging.destination.kind
andmessaging.source.kind
.
(#3214,
#3348) - Define attributes collected for
cosmosdb
by Cosmos DB SDK
(#3097) - Clarify stability requirements of semantic conventions
(#3225) - BREAKING: Change span statuses for gRPC server spans.
(#3333) - Stabilize key components of
service.*
andtelemetry.sdk.*
resource
semantic conventions.
(#3202) - Fixed attributes requirement level in semantic conventions for hardware metrics
(#3258) - Added AWS S3 semantic conventions.
(#3251) - Fix units in the Kafka metric semantic conventions.
(#3300) - Add Trino to Database specific conventions
(#3347) - Change
db.statement
to only be collected if there is sanitization.
(#3127) - BREAKING: Remove
http.status_code
attribute from the
http.server.active_requests
metric.
(#3366) - Mark attribute requirement levels as stable
(#3368)
Compatibility
- No changes.
OpenTelemetry Protocol
- Declare OTLP stable.
(#3274)
SDK Configuration
- No changes.
Telemetry Schemas
- No changes.
Common
- No changes.
New Contributors
- @codyborders made their first contribution in #3305
- @JamieDanielson made their first contribution in #3292
- @sourabh1007 made their first contribution in #3097
- @AlexanderWert made their first contribution in #3251
- @Kielek made their first contribution in #3348
- @electrum made their first contribution in #3347
- @avzis made their first contribution in #3127
Release v1.19.0
v1.19.0 (2023-03-06)
Context
- No changes.
Traces
- No changes.
Metrics
- Add unit to View's Instrument selection criteria.
(#3184) - Add metric requirement levels "Required", "Recommended", and "Opt-In".
(#3237)
Logs
- Rename Logs API to Logs Bridge API to prevent confusion.
(#3197) - Move event language from log README to event-api.
(#3252)
Resource
- Clarify how to collect
host.id
for non-containerized systems.
(#3173)
Semantic Conventions
- Move X-Ray Env Variable propagation to span link instead of parent for AWS Lambda.
(#3166) - Add heroku resource semantic conventions.
#3075 - BREAKING: Rename faas.execution to faas.invocation_id
(#3209) - BREAKING: Change faas.max_memory units to Bytes instead of MB
(#3209) - BREAKING: Expand scope of faas.id to cloud.resource_id
(#3188) - Add Connect RPC specific conventions
(#3116) - Rename JVM metric attribute value from
nonheap
tonon_heap
(#3250) - Mark the attribute naming guidelines in the specification as stable.
(#3220) - Mark telemetry schema readme stable.
(#3221) - Remove mention of
net.transport
from HTTP semantic conventions
(#3244) - Clarifies that if an HTTP client request is explicitly made to an IP address, e.g.
http://x.x.x.x:8080
, thennet.peer.name
SHOULD be the IP addressx.x.x.x
(#3276) - Mark
net.sock.host.port
as conditionally required.
(#3246) - Rename Optional attribute requirement level to Opt-In.
(#3228) - Rename
http.user_agent
touser_agent.original
.
(#3190) - Expand the declaration of
pool.name
.
(#3050)
Compatibility
- Update Zipkin remoteEndpoint preferences.
(#3087)
OpenTelemetry Protocol
- Declare OTLP/JSON Stable.
(#2930)
SDK Configuration
- No changes.
Telemetry Schemas
- No changes.
Common
- No changes.
New Contributors
- @martinknechtel made their first contribution in #3159
- @joshcarp made their first contribution in #3116
- @asafm made their first contribution in #3184
- @moonbox3 made their first contribution in #3121
- @haddasbronfman made their first contribution in #3050
- @braydonk made their first contribution in #3207