Release 1.21.0

CHANGELOG.md

@@ -13,8 +13,38 @@ release.
 
 ### Metrics
 
+### Logs
+
+### Resource
+
+### Compatibility
+
+### OpenTelemetry Protocol
+
+### SDK Configuration
+
+### Telemetry Schemas
+
+### Common
+
+### Supplemenatary Guidelines
+
+## v1.21.0 (2023-05-09)
+
+### Context
+
+- No changes.
+
+### Traces
+
+- No changes.
+
+### Metrics
+
 - Add experimental histogram advice API.
   ([#3216](https://github.com/open-telemetry/opentelemetry-specification/pull/3216))
+- Recommended non-prefixed units for metric instrument semantic conventions.
+  ([#3312](https://github.com/open-telemetry/opentelemetry-specification/pull/3312))
 - Recommended cardinality limits to protect metrics pipelines against
   excessive data production from a single instrument.
   ([#2960](https://github.com/open-telemetry/opentelemetry-specification/pull/2960))
@@ -30,73 +60,26 @@ release.
   ([#3345](https://github.com/open-telemetry/opentelemetry-specification/pull/3354))
 - Drop logger include_trace_context parameter.
   ([#3397](https://github.com/open-telemetry/opentelemetry-specification/pull/3397))
+- Clarify how ObservedTimestamp field is set if unspecified
+  ([#3385](https://github.com/open-telemetry/opentelemetry-specification/pull/3385))
 - Mark logs bridge API / SDK as stable.
   ([#3376](https://github.com/open-telemetry/opentelemetry-specification/pull/3376))
 - Mark LogRecord Environment Variables as stable.
   ([#3449](https://github.com/open-telemetry/opentelemetry-specification/pull/3449))
 
 ### Resource
 
-### Semantic Conventions
-
-- Clarify the scope of the HTTP client span.
- ([#3290](https://github.com/open-telemetry/opentelemetry-specification/pull/3290))
-- Add moratorium on relying on schema transformations for telemetry stability
-  ([#3380](https://github.com/open-telemetry/opentelemetry-specification/pull/3380))
-- Mark "Instrumentation Units" and "Instrumentation Types" sections of the general
-  metric semantic conventions as stable
-  ([#3294](https://github.com/open-telemetry/opentelemetry-specification/pull/3294))
-- Add clarification that UCUM c/s variant applies to all units other than `1` and
-  those using [annotations](https://ucum.org/ucum.html#para-curly).
-  ([#3393](https://github.com/open-telemetry/opentelemetry-specification/pull/3393))
-- Specify that seconds should be used for measuring durations.
-  ([#3388](https://github.com/open-telemetry/opentelemetry-specification/pull/3388))
-- Change http.server.duration and http.client.duration units to seconds
-  ([#3390](https://github.com/open-telemetry/opentelemetry-specification/pull/3390))
-- BREAKING: Remove `messaging.consumer.id`, make `messaging.client_id` generic
-  ([#3336](https://github.com/open-telemetry/opentelemetry-specification/pull/3336))
-- Add transition plan for upcoming breaking changes to the unstable HTTP semantic
-  conventions.
-  ([#3443](https://github.com/open-telemetry/opentelemetry-specification/pull/3443))
-- Rename `net.peer.*`, `net.host.*`, and `net.sock.*` attributes to align with ECS
-  ([#3402](https://github.com/open-telemetry/opentelemetry-specification/pull/3402))
-    BREAKING: rename `net.peer.name` to `server.address` on client side and to `client.address` on server side,
-     `net.peer.port` to `server.port` on client side and to `client.port` on server side,
-     `net.host.name` and `net.host.port` to `server.name` and `server.port` (since `net.host.*` attributes only applied to server instrumentation)
-     `net.sock.peer.addr` to `server.socket.address` on client side and to `client.socket.address` on server side,
-     `net.sock.peer.port` to `server.socket.port` on client side and to `client.socket.port` on server side,
-     `net.sock.peer.name` to `server.socket.domain` (since `net.sock.peer.name` only applied to client instrumentation),
-     `net.sock.host.addr` to `server.socket.address` (since `net.sock.host.*` only applied to server instrumentation),
-     `net.sock.host.port` to `server.socket.port` (similarly since `net.sock.host.*` only applied to server instrumentation),
-     `http.client_ip` to `client.address`
-- BREAKING: Introduce `network.transport` defined as
-  [OSI Transport Layer](https://osi-model.com/transport-layer/) or
-  [Inter-process Communication method](https://en.wikipedia.org/wiki/Inter-process_communication).
-  Introduce `network.type` defined as [OSI Network Layer](https://osi-model.com/network-layer/)
-  or non-OSI equivalent. Remove `net.transport` and `net.sock.family`.
-  Rename `net.protocol.*` to `network.protocol.*`,
-  `net.host.connection.*` to `network.connection.*`, and
-  `net.host.carrier.*` to `network.carrier.*`.
-  ([#3426](https://github.com/open-telemetry/opentelemetry-specification/pull/3426))
-- BREAKING: Adopt ECS attributes in HTTP semantic conventions.
-  Renames: `http.method` to `http.request.method`,
-  `http.status_code` to `http.response.status_code`,
-  `http.request_content_length` to `http.request.body.size`,
-  `http.response_content_length` to `http.response.body.size`,
-  `http.url` to `url.full`,
-  `http.scheme` to `url.scheme`,
-  and removes `http.target` breaking it down to `http.target` to `url.path`, `url.query`, and `url.fragment`.
-  ([#3355](https://github.com/open-telemetry/opentelemetry-specification/pull/3355))
+- No changes.
 
 ### Compatibility
 
-### Supplemenatary Guidelines
-
-- Add guidance to use service-supported propagation formats as default for AWS SDK client calls.
-  ([#3212](https://github.com/open-telemetry/opentelemetry-specification/pull/3212))
+- Mark OpenCensus compatibility spec as stable
+  ([#3425](https://github.com/open-telemetry/opentelemetry-specification/pull/3425))
 
 ### OpenTelemetry Protocol
 
+- No changes.
+
 ### SDK Configuration
 
 - Lay initial groundwork for file configuration
@@ -109,11 +92,18 @@ release.
 
 ### Telemetry Schemas
 
+- No changes.
+
 ### Common
 
 - Add log entries to specification README.md contents.
   ([#3435](https://github.com/open-telemetry/opentelemetry-specification/pull/3435))
 
+### Supplemenatary Guidelines
+
+- Add guidance to use service-supported propagation formats as default for AWS SDK client calls.
+  ([#3212](https://github.com/open-telemetry/opentelemetry-specification/pull/3212))
+
 ## v1.20.0 (2023-04-07)
 
 ### Context
@@ -132,8 +122,6 @@ release.
 
 - Clarify that units should use UCUM case sensitive variant.
   ([#3306](https://github.com/open-telemetry/opentelemetry-specification/pull/3306))
-- Recommended non-prefixed units for metric instrument semantic conventions.
-  ([#3312](https://github.com/open-telemetry/opentelemetry-specification/pull/3312))
 - Remove No-Op instrument and Meter creation requirements.
   ([#3322](https://github.com/open-telemetry/opentelemetry-specification/pull/3322))
 - Fixed attributes requirement level in semantic conventions for hardware metrics
@@ -160,8 +148,6 @@ release.
 
 ### Semantic Conventions
 
-- Add k8s.cluster.uid semantic convention
-  ([#3267](https://github.com/open-telemetry/opentelemetry-specification/pull/3267))
 - Clarify that attribute requirement levels apply to the instrumentation library
   ([#3289](https://github.com/open-telemetry/opentelemetry-specification/pull/3289))
 - Fix grammatical number of metric units.