From 611c1816fabda3b38d2cc3ce6059317760b4a954 Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Fri, 5 May 2023 15:47:16 +0200 Subject: [PATCH 1/2] Release 1.21.0 --- CHANGELOG.md | 53 +++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 48 insertions(+), 5 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1b5f1f7b9d5..0c3a2fdaf31 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -13,8 +13,38 @@ release. ### Metrics +### Logs + +### Resource + +### Semantic Conventions + +### Compatibility + +### OpenTelemetry Protocol + +### SDK Configuration + +### Telemetry Schemas + +### Common + +## 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)) - Specify second unit (`s`) and advice bucket boundaries of `[]` for `process.runtime.jvm.gc.duration`. ([#3458](https://github.com/open-telemetry/opentelemetry-specification/pull/3458)) @@ -25,6 +55,8 @@ 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. @@ -32,10 +64,14 @@ release. ### Resource +- No changes. + ### Semantic Conventions +- Semconv for hardware metrics, network metrics and attributes + ([#3344](https://github.com/open-telemetry/opentelemetry-specification/pull/3344)) - Clarify the scope of the HTTP client span. - ([#3290](https://github.com/open-telemetry/opentelemetry-specification/pull/3290)) + ([#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 @@ -46,6 +82,10 @@ release. ([#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)) +- Add a note about not splitting UpDownCounter timeseries + ([#3367](https://github.com/open-telemetry/opentelemetry-specification/pull/3367)) +- Add k8s.cluster.uid semantic convention + ([#3267](https://github.com/open-telemetry/opentelemetry-specification/pull/3267)) - 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 @@ -53,8 +93,13 @@ release. ### Compatibility +- 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 @@ -67,6 +112,8 @@ release. ### Telemetry Schemas +- No changes. + ### Common - Add log entries to specification README.md contents. @@ -90,8 +137,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 @@ -118,8 +163,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. From c1f3e591f8a30bfa670652247c1505fa80080e2a Mon Sep 17 00:00:00 2001 From: Carlos Alberto Cortez Date: Fri, 12 May 2023 16:10:43 +0200 Subject: [PATCH 2/2] Remove semantic conventions section from the CHANGELOG. --- CHANGELOG.md | 63 +++------------------------------------------------- 1 file changed, 3 insertions(+), 60 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index d18459a5bdc..da0828ca221 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,8 +17,6 @@ release. ### Resource -### Semantic Conventions - ### Compatibility ### OpenTelemetry Protocol @@ -29,6 +27,8 @@ release. ### Common +### Supplemenatary Guidelines + ## v1.21.0 (2023-05-09) ### Context @@ -71,63 +71,6 @@ release. - No changes. -### Semantic Conventions - -- Semconv for hardware metrics, network metrics and attributes - ([#3344](https://github.com/open-telemetry/opentelemetry-specification/pull/3344)) -- 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)) -- Add a note about not splitting UpDownCounter timeseries - ([#3367](https://github.com/open-telemetry/opentelemetry-specification/pull/3367)) -- Add k8s.cluster.uid semantic convention - ([#3267](https://github.com/open-telemetry/opentelemetry-specification/pull/3267)) -- 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)) - ### Compatibility - Mark OpenCensus compatibility spec as stable @@ -155,7 +98,7 @@ release. - 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.