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)

Release v1.4.0

v1.4.0 (2021-06-07)

Context

• No changes.

Traces

• Add schema_url support to Tracer. (#1666)
• Add Dropped Links Count to non-otlp exporters section (#1697)
• Add note about reporting dropped counts for attributes, events, links. (#1699)

Metrics

• Add schema_url support to Meter. (#1666)
• Adds detail about when to use StartTimeUnixNano and handling of unknown start-time resets. (#1646)
• Expand Gauge metric description in the data model (#1661)
• Expand Histogram metric description in the data model (#1664)
• Added Experimental Metrics API specification.
  (#1401,
  #1557,
  #1578,
  #1590,
  #1594,
  #1617,
  #1645,
  #1657,
  #1665,
  #1672,
  #1674,
  #1675,
  #1703,
  #1704,
  #1731,
  #1733)
• Mark relevant portions of Metrics Data Model stable (#1728)

Logs

• No changes.

Resource

• Add schema_url support to Resource. (#1692)
• Clarify result of Resource merging and ResourceDetector aggregation in case of error. (#1726)

Semantic Conventions

• Add JSON RPC specific conventions (#1643).
• Add Memcached to Database specific conventions (#1689).
• Add semantic convention attributes for the host device and added OS name and version (#1596).
• Add CockroachDB to Database specific conventions (#1725).

Compatibility

• No changes.

OpenTelemetry Protocol

• No changes.

SDK Configuration

• Add OTEL_SERVICE_NAME environment variable. (#1677)

Release v1.3.0

v1.3.0 (2021-05-05)

Context

• No changes.

Traces

• Get Tracer should use an empty string if the specified name is null. (#1654)
• Clarify how to record dropped attribute count in non-OTLP formats. (#1662)

Metrics

• Expand description of Event Model and Instruments. (#1614)
• Flesh out metric identity and single-write principle. (#1574)
• Expand Sum metric description in the data model and delta-to-cumulative handling. (#1618)
• Remove the "Func" name, use "Asynchronous" and "Observable". (#1645)
• Add details to UpDownCounter API. (#1665)
• Add details to Histogram API. (#1657)

Logs

• Clarify "key/value pair list" vs "map" in Log Data Model. (#1604)

Semantic Conventions

• Fix the inconsistent formatting of semantic convention enums. (#1598)
• Add details for filling resource for AWS Lambda. (#1610)
• Add already specified messaging.rabbitmq.routing_key span attribute key to the respective YAML file. (#1651)
• Clarify usage of "otel." attribute namespace. (#1640)
• Add possibility to disable db.statement via instrumentation configuration. (#1659)

Compatibility

• No changes.

OpenTelemetry Protocol

• Fix incorrect table of transient errors. (#1642)
• Clarify that 64 bit integer numbers are decimal strings in OTLP/JSON. (#1637)

SDK Configuration

• Add OTEL_EXPORTER_JAEGER_TIMEOUT environment variable. (#1612)
• Add OTEL_EXPORTER_ZIPKIN_TIMEOUT environment variable. (#1636)

Release v1.2.0

v1.2.0 (2021-04-14)

Context

• Clarify composite TextMapPropagator method required and optional arguments. (#1541)
• Clarify B3 requirements and configuration. (#1570)

Traces

• Add ForceFlush to Span Exporter interface (#1467)
• Clarify the description for the TraceIdRatioBased sampler needs to include the sampler's sampling ratio. (#1536)
• Define the fallback tracer name for invalid values.
  (#1534)
• Clarify non-blocking requirement from span API End. (#1555)
• Remove the Included Propagators section from trace API specification that was a duplicate of the Propagators Distribution of the context specification. (#1556)
• Remove the Baggage API propagator notes that conflict with the API Propagators Operations section and fix #1526. (#1575)

Metrics

• Adds new metric data model specification (#1512)

Semantic Conventions

• Add semantic conventions for AWS SDK operations and DynamoDB (#1422)
• Add details for filling semantic conventions for AWS Lambda (#1442)
• Update semantic conventions to distinguish between int and double (#1550)
• Add semantic convention for AWS ECS task revision (#1581)

Compatibility

• Add initial OpenTracing compatibility section.
  (#1101)

Release v1.1.0

v1.1.0 (2021-03-11)

Traces

• Implementations can ignore links with invalid SpanContext(#1492)
• Add none as a possible value for OTEL_TRACES_EXPORTER to disable export
  (#1439)
• Add ForceFlush to SDK's TracerProvider (#1452)

Metrics

• Add none as a possible value for OTEL_METRICS_EXPORTER to disable export
  (#1439)

Logs

Semantic Conventions

• Add elasticsearch to db.system semantic conventions (#1463)
• Add arch to host semantic conventions (#1483)
• Add runtime to container semantic conventions (#1482)
• Rename gcp_gke to gcp_kubernetes_engine to have consistency with other
  Google products under cloud.infrastructure_service (#1496)
• http.url MUST NOT contain credentials (#1502)
• Add aws.eks.cluster.arn to EKS specific semantic conventions (#1484)
• Rename zone to availability_zone in cloud semantic conventions (#1495)

Release v1.0.1

New:

• Fix rebase issue for span limit default values (#1429)

See v1.0.0 for a list of substantial changes.

Release v1.0.0

v1.0.0

This version of the OpenTelemetry specification includes a stable release of the Tracing API and Tracing SDK components.

Every document in the specification is now marked as either stable or experimental. Please read the versioning and support document for details.

Caveats

• Missed #1429 we will do a patch release v1.0.1 asap.

As part of this release we are marking a large part of our specification stable:

• Trace (API/SDK)
• Context
• Baggage

New:

• Add cloud.infrastructure_service resource attribute
  (#1112)
• Add SpanLimits as a configuration for the TracerProvider(#1416)

Updates:

• Update default limit for span attributes, events, links to 128(#1419)
• Update OT Trace propagator environment variable to match latest name(#1406)
• Remove Metrics SDK specification to avoid confusion, clarify that Metrics API
  specification is not recommended for client implementation
  (#1401)
• Rename OTEL_TRACE_SAMPLER and OTEL_TRACE_SAMPLER_ARG env variables to OTEL_TRACES_SAMPLER and OTEL_TRACES_SAMPLER_ARG
  (#1382)
• Mark some entries in compliance matrix as optional(#1359)
  SDKs are free to provide support at their discretion.
• Rename signal-specific variables for OTLP_EXPORTER_* to OTLP_EXPORTER_TRACES_* and OTLP_EXPORTER_METRICS_*(#1362)
• Versioning and stability guarantees for OpenTelemetry clients(#1291)
• Additional Cassandra semantic attributes
  (#1217)
• OTEL_EXPORTER environment variable replaced with OTEL_TRACES_EXPORTER and
  OTEL_METRICS_EXPORTER which each accept only a single value, not a list.
  (#1318)
• process.runtime.description resource convention: Add java.vm.name
  (#1242)
• Refine span name guideline for SQL database spans
  (#1219)
• Add RPC semantic conventions for metrics
  (#1162)
• Clarify Description usage on Status API
  (#1257)
• Add/Update Status + error mapping for Jaeger & Zipkin Exporters
  (#1257)
• Resource's service.name MUST have a default value, service.instance.id is not
  required.
  (#1269)
  • Clarified in #1294
• Add requirement that the SDK allow custom generation of Trace IDs and Span IDs
  (#1006)
• Add default ratio when TraceIdRatioSampler is specified by environment variable but
  no ratio is.
  (#1322)
• Require schemed endpoints for OTLP exporters
  (1234)
• Resource SDK: Reverse (suggested) order of Resource.Merge parameters, remove
  special case for empty strings
  (#1345)
• Resource attributes: lowerecased the allowed values of the aws.ecs.launchtype
  attribute
  (#1339)
• Trace Exporters: Fix TODOs in Jaeger exporter spec
  (#1374)
• Clarify that Jaeger/Zipkin exporters must rely on the default Resource to
  get service.name if none was specified.
  (#1386)
• Modify OTLP/Zipkin Exporter format variables for 1.0 (allowing further specification post 1.0)
  (#1358)
• Add k8s.node semantic conventions (#1390)
• Clarify stability for both OTLP/HTTP and signals in OTLP.
  (#1400)