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 and OTEL_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 with network.(peer|local).(address|port). (#3713)

Supplementary Guidelines

• No changes.

New Contributors

• @vprithvi made their first contribution in #3726

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 be 1.
  (#3670)
• Rename "advice" to "advisory parameters".
  (#3662)
• Clarify the minimal implementation of a View's attribute_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 define ForceFlush 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

• @marcalff made their first contribution in #3567
• @shalevr made their first contribution in #3569

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 and sdk-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) to net.protocol.(name|version)
  (#3272)
• Replace http.flavor with net.protocol.(name|version)
  (#3272)
• Metric requirement levels are now stable
  (#3271)
• BREAKING: remove messaging.destination.kind and messaging.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.* and telemetry.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 to non_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, then net.peer.name SHOULD be the IP address x.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 to user_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

Release v1.18.0

v1.18.0 (2023-02-09)

Context

• No changes.

Traces

• Clarify guidance regarding excessive logging when attributes are dropped or truncated.
  (#3151)

Metrics

• No changes.

Logs

• Define BatchLogRecordProcessor default configuration values.
  (#3002)
• Clarify guidance regarding excessive logging when attributes are dropped or truncated.
  (#3151)

Resource

• No changes.

Semantic Conventions

• Add Cloud Spanner and Microsoft SQL Server Compact to db.system semantic conventions
  (#3105).
• Enable semantic convention tooling for metrics in spec
  (#3119)
• Rename google openshift platform attribute from google_cloud_openshift to gcp_openshift
  to match the existing cloud.provider prefix.
  (#3095)
• Changes http server span names from {http.route} to {http.method} {http.route}
  (when route is available), and from HTTP {http.method} to {http.method} (when
  route is not available).
  Changes http client span names from HTTP {http.method} to {http.method}.
  (#3165)
• Mark http.server.duration and http.client.duration metrics as required, and mark
  all other HTTP metrics as optional.
  #3158
• Add net.host.port to http.server.active_requests metrics attributes.
  #3158
• http.route SHOULD contain the "application root" if there is one.
  (#3164)

Compatibility

• Add condition with sum and count for Prometheus summaries
  (3059).
• Clarify prometheus unit conversions
  (#3066).
• Define conversion mapping from OTel Exponential Histograms to Prometheus Native
  Histograms.
  (#3079)
• Fix Prometheus histogram metric suffixes. Bucket series end in _bucket
  (#3018).

OpenTelemetry Protocol

• No changes.

SDK Configuration

• Add log-specific attribute limit configuration and clarify that general
  attribute limit configuration also apply to log records
  (#2861).

Telemetry Schemas

• No changes.

Common

• No changes.

New Contributors

• @mrblonde91 made their first contribution in #3105
• @khanhntd made their first contribution in #3059