Release v1.13.0

v1.13.0 (2022-09-19)

Traces

• Clarify the return of Export(batch) in the Batch Span Processor and exporter concurrency (#2452)
• Clarify that Context should not be mutable when setting a span (#2637)
• Clarify that ForceFlush is a required method on SpanExporter interface (#2654)

Metrics

• Add experimental OTEL_EXPORTER_OTLP_DEFAULT_HISTOGRAM_AGGREGATION variable for
  configuring default histogram aggregation of OTLP metric exporter (#2619)
• Clarify async instrument callback identity (#2538)
• Prometheus export: Only monotonic sum are counters (with _total) (#2644)
• [OM/OTLP] Use _created for StartTimeUnixNano and vice-versa (#2645)
• Prometheus compatibility: use target_info metric instead of "target" info MF (#2701)
• Add optional Zero Threshold for Exponential Histograms to the metrics data model (#2665)
• Change the inclusivity of exponential histogram bounds (#2633)
• Add process.threads host metric semantic convention. (#2705).

Logs

• Update log SDK to allow log processors to mutate log records (#2681).
• Add experimental Events and Logs API specification (#2676)
• Align log SDK and API component naming (#2768).
• Add the signal-specific OTEL_EXPORTER_OTLP_LOGS_* environment variables (#2782).

Resource

• Update the version of the W3C Baggage specification used for OTEL_RESOURCE_ATTRIBUTES (#2670)

Semantic Conventions

• Add net.app.protocol.* attributes (#2602)
• Add network metrics to process semantic conventions (#2556)
• Adopt attribute requirement levels in semantic conventions (#2594)
• Add semantic conventions for GraphQL (#2456)
• Change cloudevents.event_spec_version and cloudevents.event_type level from required to recommended (#2618)
• Change faas.document.time and faas.time level from required to recommended (#2627)
• Add rpc.grpc.status_code to RPC metric semantic conventions (#2604)
• Add http.*.*.size metric semantic conventions for tracking size of requests
  / responses for http servers / clients (#2588)
• BREAKING: rename net.peer.ip to net.sock.peer.addr, net.host.ip to net.sock.host.addr,
  net.peer.name to net.sock.peer.name for socket-level instrumentation.
  Define socket-level attributes and clarify logical peer and host attributes meaning (#2594)
• Add semantic conventions for JVM buffer pool usage (#2650)
• Improve the definition of state attribute for metric system.network.connections (#2663)
• Add process.parent_pid attribute for use in reporting parent process id (PID) (#2691)
• Add OpenSearch to db.system semantic conventions (#2718)
• Clarify when "count" is used instead of pluralization (#2613)
• Add the convention 'type' to the YAML definitions for all existing semantic conventions (#2693)
• Remove alternative attribute sets from HTTP semantic conventions (#2469)

OpenTelemetry Protocol

• Add support for partial success in an OTLP export response (#2696)

SDK Configuration

• Mark OTEL_METRIC_EXPORT_INTERVAL, OTEL_METRIC_EXPORT_TIMEOUT
  environment variables as Stable (#2658)

Telemetry Schemas

• Introduce "split" metric schema transformation (#2653)

Common

• Introduce Instrumentation Scope Attributes (#2579)
  • Define Instrumentation Scope Attributes as non identifiers (#2789)

New Contributors

• @laurit made their first contribution in #2456
• @ahayworth made their first contribution in #2642
• @gouthamve made their first contribution in #2644
• @utpilla made their first contribution in #2583
• @breedx-splk made their first contribution in #2659
• @evan-bradley made their first contribution in #2669
• @ppatierno made their first contribution in #2694
• @CleanCut made their first contribution in #2693
• @davidmirza408 made their first contribution in #2691
• @foadnh made their first contribution in #2699
• @lgfa29 made their first contribution in #2670
• @sharp-pixel made their first contribution in #2718
• @pantuza made their first contribution in #2723
• @kovrus made their first contribution in #2745
• @scheler made their first contribution in #2676

Full Changelog: v1.12.0...v1.13.0

Release v1.12.0

v1.12.0 (2022-06-10)

Context

• No changes.

Traces

• No changes.

Metrics

• Clarify that API support for multi-instrument callbacks is permitted.
  (#2263).
• Clarify SDK behavior when view conflicts are present
  (#2462).
• Clarify MetricReader.Collect result
  (#2495).
• Specify optional support for an Exponential Histogram Aggregation.
  (#2252)
• Update Prometheus Sums for handling delta counter case
  (#2570).
• Supplementary guidance for metrics additive property
  (#2571).

Logs

• OTLP Logs are now Stable
  (#2565)

Resource

• No changes.

Semantic Conventions

• Add semantic conventions for JVM CPU metrics
  (#2292)
• Add details for FaaS conventions for Azure Functions and allow FaaS/Cloud
  resources as span attributes on incoming FaaS spans
  (#2502)
• Define attribute requirement levels
  (#2522)
• Initial addition of Kafka metrics
  (#2485).
• Add semantic conventions for Kafka consumer metrics
  (#2536)
• Add database connection pool metrics semantic conventions
  (#2273).
• Specify how to obtain a Ruby thread's id
  (#2508).
• Refactor jvm classes semantic conventions
  (#2550).
• Add browser.* attributes
  (#2353).
• Change JVM runtime metric process.runtime.jvm.memory.max
  to process.runtime.jvm.memory.limit
• (#2605).

Compatibility

• No changes.

OpenTelemetry Protocol

• No changes.

SDK Configuration

• No changes.

Telemetry Schemas

• No changes.

Common

• Move non-otlp.md to common directory
  (#2587).

Release v1.11.0

v1.11.0 (2022-05-04)

Context

• No changes.

Traces

• No changes.

Metrics

• Clarify that API support for multi-instrument callbacks is permitted.
  (#2263).
• Drop histogram aggregation, default to explicit bucket histogram
  (#2429)
• Clarify SDK behavior when view conflicts are present
  (#2462).
• Add support for exemplars on OpenMetrics counters
  (#2483)
• Clarify MetricReader.Collect result
  (#2495).
• Add database connection pool metrics semantic conventions
  (#2273).

Logs

• Update com.google.* to gcp.* in logs data model
  (#2514).

Resource

• No changes.

Semantic Conventions

• Note added that net.peer.name SHOULD NOT be set if capturing it would require an
  extra reverse DNS lookup. And moved net.peer.name from common http attributes to
  just client http attributes.
  (#2446)
• Add net.host.name and net.host.ip conventions for rpc server spans.
  (#2447)
• Allow all metric conventions to be either synchronous or asynchronous.
  (#2458
• Update JVM metrics with JMX Gatherer values
  (#2478)
• Add HTTP/3
  (#2507)
• Map SunOS to solaris for os.type resource attribute
  (#2509)

Compatibility

• No changes.

OpenTelemetry Protocol

• Clarify gRPC insecure option (#2476)
• Specify that OTLP/gRPC clients should retry on RESOURCE_EXHAUSTED code only if the server signals backpressure to indicate a possible recovery.
  (#2480)

SDK Configuration

• No changes.

Telemetry Schemas

• No changes.

Common

• Define semantic conventions and instrumentation stability.
  (#2180)
• Loosen requirement for a major version bump
  ([#2510](https://github.com/open-t

Release v1.10.0

v1.10.0 (2022-04-01)

Context

• No changes.

Traces

• Introduce the concept of Instrumentation Scope to replace/extend Instrumentation
  Library. The Tracer is now associated with Instrumentation Scope
  (#2276).
• Add OTEL_EXPORTER_JAEGER_PROTOCOL environment variable to select the protocol
  used by the Jaeger exporter.
  (#2341)
• Add documentation REQUIREMENT for adding attributes at span creation.
  (#2383).

Metrics

• Initial Prometheus <-> OTLP datamodel specification
  (#2266)
• Introduce the concept of Instrumentation Scope to replace/extend Instrumentation
  Library. The Meter is now associated with Instrumentation Scope
  (#2276).
• Specify the behavior of duplicate instrumentation registration in the API, specify
  duplicate conflicts in the data model, specify how the SDK is meant to report and
  assist the user when these conflicts arise.
  (#2317).
• Clarify that expectations for user callback behavior are documentation REQUIREMENTs.
  (#2361).
• Specify how to handle prometheus exemplar timestamp and attributes
  (#2376)
• Clarify that the periodic metric reader is the default metric reader to be
  paired with push metric exporters (OTLP, stdout, in-memory)
  (#2379).
• Convert OpenMetrics Info and StateSet metrics to non-monotonic sums
  (#2380)
• Clarify that MetricReader has one-to-one mapping to MeterProvider.
  (#2406).
• For prometheus metrics without sums, leave the sum unset
  (#2413)
• Specify default configuration for a periodic metric reader that is associated with
  the stdout metric exporter.
  (#2415).
• Clarify the manner in which aggregation and temporality preferences
  are encoded via MetricReader parameters "on the basis of instrument
  kind". Rename the environment variable
  OTEL_EXPORTER_OTLP_METRICS_TEMPORALITY_PREFERENCE used to set the
  preference to be used when auto-configuring an OTLP Exporter,
  defaults to CUMULATIVE, with DELTA an option that makes Counter,
  Asynchronous Counter, and Histogram instruments choose Delta
  temporality by default.
  (#2404).
• Clarify that instruments are enabled by default, even when Views are configured.
  Require support for the match-all View expression having name=* to support
  disabling instruments by default.
  (#2417).
• Mark Metrics SDK spec as Mixed, with most components moving to Stable, while
  Exemplar remaining Feature-freeze.
  (#2304)
• Clarify how metric metadata and type suffixes are handled
  (#2440)

Logs

• Add draft logging library SDK specification
  (#2328)
• Add InstrumentationScope/Logger Name to log data model
  (#2359)
• Remove flush method on LogEmitter
  (#2405)
• Declare Log Data Model Stable
  (#2387)

Resource

• No changes.

Semantic Conventions

• Define span structure for HTTP retries and redirects.
  (#2078)
• Changed rpc.system to an enum (allowing custom values), and changed the
  rpc.system value for .NET WCF from wcf to dotnet_wcf.
  (#2377)
• Define JavaScript runtime semantic conventions.
  (#2290)
• Add semantic conventions for CloudEvents.
  (#1978)
• Add process.cpu.utilization metric.
  (#2436)
• Add rpc.system value for Apache Dubbo.
  (#2453)

Compatibility

• Mark the OpenTracing compatibility section as stable.
  (#2327)

OpenTelemetry Protocol

• Add experimental JSON serialization format
  (#2235)
• Parameters for private key and its chain added
  (#2370)

SDK Configuration

• No changes.

Telemetry Schemas

• No changes.

Common

• Describe how to convert non-string primitives for protocols which only support strings
  (#2343)
• Add "Mapping Arbitrary Data to OTLP AnyValue" document.
  (#2385)

Release v1.9.0

v1.9.0 (2022-02-14)

Context

• No changes.

Traces

• Clarify StartSpan returning the parent as a non-recording Span when no SDK is in use
  (#2121)
• Align Jaeger remote sampler endpoint with OTLP endpoint.
  (#2246)
• Add JaegerRemoteSampler spec.
  (#2222)
• Add support for probability sampling in the OpenTelemetry tracestate entry and
  add optional specification for consistent probability sampling.
  (#2047)
• Change description and default value of OTEL_EXPORTER_JAEGER_ENDPOINT env var
  to point to the correct HTTP port and correct description of OTEL_TRACES_EXPORTER
  (#2333).

Metrics

• Rename None aggregation to Drop.
  (#2101)
• Add details to the Prometheus Exporter requirements.
  (#2124)
• Consolidate the aggregation/aggregator term.
  (#2153)
• Remove the concept of supported temporality, keep preferred.
  (#2154)
• Rename extra dimensions to extra attributes.
  (#2162)
• Mark In-memory, OTLP and Stdout exporter specs as Stable.
  (#2175)
• Remove usage of baggage in View from initial SDK specification.
  (#2215)
• Add to the supplemental guidelines for metric SDK authors text about implementing
  attribute-removal Views for asynchronous instruments.
  (#2208)
• Clarify integer count instrument units.
  (#2210)
• Use UCUM units in Metrics Semantic Conventions.
  (#2199)
• Add semantic conventions for process metrics.
  #2032
• Changed default Prometheus Exporter host from 0.0.0.0 to localhost.
  (#2282)
• Clarified wildcard and predicate support in metrics SDK View API.
  (#2325)

Logs

• Fix attributes names in Google Cloud Logging mapping.
  (#2093)
• Add OTEL_LOGS_EXPORTER environment variable.
  (#2196)
• Added ObservedTimestamp to the Log Data Model.
  (#2184)
• Change mapping for log_name of Google Cloud Logging.
  (#2092)
• Drop Log name field
  (#2271)

Resource

• No changes.

Semantic Conventions

• Align runtime metric and resource namespaces
  (#2112)
• Prohibit usage of retired names in semantic conventions.
  (#2191)
• Add device.manufacturer to describe mobile device manufacturers.
  (2100)
• Change golang namespace to 'go', rather than 'gc'
  (#2262)
• Add JVM memory runtime semantic
  conventions. (#2272)
• Add opentracing.ref_type semantic convention.
  (#2297)

Compatibility

• Simplify Baggage handling in the OpenTracing Shim layer.
  (#2194)
• State that ONLY error mapping can happen in the OpenTracing Shim layer.
  (#2148)
• Define the instrumentation library name for the OpenTracing Shim.
  (#2227)
• Add a Start Span section to the OpenTracing Shim.
  (#2228)

OpenTelemetry Protocol

• Rename OTEL_EXPORTER_OTLP_SPAN_INSECURE to OTEL_EXPORTER_OTLP_TRACES_INSECURE and
  OTEL_EXPORTER_OTLP_METRIC_INSECURE to OTEL_EXPORTER_OTLP_METRICS_INSECURE
  so they match the naming of all other OTLP environment variables.
  (#2240)

SDK Configuration

• No changes.

Telemetry Schemas

• No changes.

Release v1.8.0

v1.8.0 (2021-11-12)

Context

• Add a section for OTel specific values in TraceState.
  (#1852)
• Add none as a possible value for OTEL_PROPAGATORS to disable context propagation.
  (#2052)

Traces

• No changes.

Metrics

• Add optional min / max fields to histogram data model.
  (#1915,
  #1983)
• Add exponential histogram to the metrics data model.
  (#1935)
• Add clarifications on how to handle numerical limits.
  (#2007)
• Add environment variables for Periodic exporting MetricReader.
  (#2038)
• Specify that the SDK must support exporters to access meter information.
  (#2040)
• Add clarifications on how to determine aggregation temporality.
  (#2013,
  #2032)
• Mark Metrics API spec as Stable.
  (#2104)
• Clarify, fix and expand documentation sections:
  (#1966),
  (#1981),
  (#1995),
  (#2002),
  (#2010)

Logs

• Fix Syslog severity number mapping in the example.
  (#2091)
• Add log.* attributes.
  (#2022)

Resource

• No changes.

Semantic Conventions

• Add k8s.container.restart_count Resource attribute.
  (#1945)
• Add "IBM z/Architecture" (s390x) to host.arch
  (#2055)
• BREAKING: Remove db.cassandra.keyspace and db.hbase.namespace, and clarify db.name
  (#1973)
• Add AWS App Runner as a cloud platform
  (#2004)
• Add Tencent Cloud as a cloud provider.
  (#2006)
• Don't set Span.Status for 4xx http status codes for SERVER spans.
  (#1998)
• Add attributes for Apache RocketMQ.
  (#1904)
• Define http tracing attributes provided at span creation time
  (#1916)
• Change meaning and discourage use of faas.trigger for FaaS clients (outgoing).
  (#1921)
• Clarify difference between container.name and k8s.container.name
  (#1980)

Compatibility

• No changes.

OpenTelemetry Protocol

• Clarify default for OTLP endpoint should, not must, be https
  (#1997)
• Specify the behavior of the OTLP endpoint variables for OTLP/HTTP more strictly
  (#1975,
  #1985)
• Make OTLP/HTTP the recommended default transport (#1969)

SDK Configuration

• Unset and empty environment variables are equivalent.
  (#2045)

Telemetry Schemas

• Added telemetry schemas documents to the specification (#2008)

Release v1.7.0

v1.7.0 (2021-09-30)

Context

• No changes.

Traces

• Prefer global user defined limits over model-specific default values. (#1893)
• Generalize the "message" event to apply to all RPC systems not just gRPC (#1914)

Metrics

• Added Experimental Metrics SDK specification. (#1673, #1730, #1840, #1842, #1864, #1828, #1888, #1912, #1913, #1938, #1958)
• Add FaaS metrics semantic conventions (#1736)
• Update env variable values to match other env variables (#1965)

Logs

• No changes.

Resource

• Exempt Resource from attribute limits. (#1892)

Semantic Conventions

• BREAKING: Change enum member IDs to lowercase without spaces, not starting with numbers.
  Change values of net.host.connection.subtype to match. (#1863)
• Lambda instrumentations should check if X-Ray parent context is valid (#1867)
• Update YAML definitions for events (#1843):
  • Mark exception as semconv type "event".
  • Add YAML definitions for grpc events.
• Add messaging.consumer_id to differentiate between message consumers. (#1810)
• Clarifications for http.client_ip and http.host. (#1890)
• Add HTTP request and response headers semantic conventions. (#1898)

Compatibility

• No changes.

OpenTelemetry Protocol

• Add environment variables for configuring the OTLP exporter protocol (grpc, http/protobuf, http/json) (#1880)
• Allow implementations to use their own default for OTLP compression, with none denotating no compression (#1923)
• Clarify OTLP server components MUST support none/gzip compression (#1955)
• Change OTLP/HTTP port from 4317 to 4318 (#1970)

SDK Configuration

• Change default value for OTEL_EXPORTER_JAEGER_AGENT_PORT to 6831. (#1812)

Release v1.6.1

v1.6.1 (2021-08-25)

This is a patch release on the previous 1.6.0 release, fixing the issue below. Users SHOULD NOT use 1.6.0.

Semantic Conventions

BREAKING: Change enum member IDs to lowercase without spaces, not starting with numbers. Change values of net.host.connection.subtype to match. (#1863)

Release v1.6.0

v1.6.0 (2021-08-06)

Users SHOULD NOT use this release anymore, but refer to the 1.6.1 release, which contains a semantic conventions bug fix.

Context

• No changes.

Traces

• Add generalized attribute count and attribute value length limits and relevant
  environment variables.
  (#1130)
• Adding environment variables for event and link attribute limits. (#1751)
• Adding SDK configuration for Jaeger remote sampler (#1791)

Metrics

• Metrics API specification Feature-freeze.
  (#1833)
• Remove MetricProcessor from the SDK spec (for now)
  (#1840)

Logs

• No changes.

Resource

• No changes.

Semantic Conventions

• Add mobile-related network state: net.host.connection.type, net.host.connection.subtype & net.host.carrier.* #1647
• Adding alibaba cloud as a cloud provider.
  (#1831)

Compatibility

• No changes.

OpenTelemetry Protocol

• Allow for OTLP/gRPC exporters to handle endpoint configuration without a scheme while still requiring them to support an endpoint configuration that includes a scheme of http or https. Reintroduce the insecure configuration option for OTLP/gRPC exporters. (#1729)
• Adding requirement to implement at least one of two transports: grpc or http/protobuf.
  (#1790)

SDK Configuration

• No changes.

Release v1.5.0

v1.5.0 (2021-07-08)

Context

• No changes.

Traces

• Adding environment variables for event and link attribute limits.
  (#1751)
• Clarify some details about span kind and the meanings of the values.
  (#1738)
• Clarify meaning of the Certificate File option.
  (#1803)

Metrics

• Clarify the limit on the instrument unit.
  (#1762)

Logs

• Declare OTLP Logs Beta. (#1741)

Resource

• No changes.

Semantic Conventions

• Clean up FaaS semantic conventions, add aws.lambda.invoked_arn.
  (#1781)
• Remove rpc.jsonrpc.method, clarify that rpc.method should be used instead.
  (#1748)

Compatibility

• No changes.

OpenTelemetry Protocol

• No changes.

SDK Configuration

• Allow selecting multiple exporters via OTEL_TRACES_EXPORTER and OTEL_METRICS_EXPORTER
  by using a comma-separated list. (#1758)