From dc6996e1fa5c8035dca81ca3cb2a21c29ac77582 Mon Sep 17 00:00:00 2001 From: Vishwesh Bankwar Date: Mon, 5 Aug 2024 09:51:39 -0700 Subject: [PATCH 1/9] Edit 1.9.0 changelog --- src/OpenTelemetry/CHANGELOG.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/src/OpenTelemetry/CHANGELOG.md b/src/OpenTelemetry/CHANGELOG.md index 100ec92d219..1f24b8b4e44 100644 --- a/src/OpenTelemetry/CHANGELOG.md +++ b/src/OpenTelemetry/CHANGELOG.md @@ -12,6 +12,11 @@ Released 2024-Jun-14 +* Exemplars are now supported as a stable feature. Please note that the + Exemplars are disabled by default. Check [OpenTelemetry Metrics + docs](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#exemplars) + to learn how to enable and customize exemplars collection. + ## 1.9.0-rc.1 Released 2024-Jun-07 From 12b81a6a3a200e3f27ae8dd4dfee53001a8e3951 Mon Sep 17 00:00:00 2001 From: Cijo Thomas Date: Mon, 5 Aug 2024 14:45:19 -0700 Subject: [PATCH 2/9] Update src/OpenTelemetry/CHANGELOG.md --- src/OpenTelemetry/CHANGELOG.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/OpenTelemetry/CHANGELOG.md b/src/OpenTelemetry/CHANGELOG.md index 1f24b8b4e44..99fa0384e35 100644 --- a/src/OpenTelemetry/CHANGELOG.md +++ b/src/OpenTelemetry/CHANGELOG.md @@ -12,7 +12,7 @@ Released 2024-Jun-14 -* Exemplars are now supported as a stable feature. Please note that the +* Exemplars are now supported as a stable feature. Please note that Exemplars are disabled by default. Check [OpenTelemetry Metrics docs](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#exemplars) to learn how to enable and customize exemplars collection. From bcb657ab8d3e9b33dbeb921f8db70f7f8e67c55f Mon Sep 17 00:00:00 2001 From: Vishwesh Bankwar Date: Tue, 6 Aug 2024 16:59:19 -0700 Subject: [PATCH 3/9] PR feedback --- RELEASENOTES.md | 9 +++++++++ src/OpenTelemetry/CHANGELOG.md | 8 +++----- 2 files changed, 12 insertions(+), 5 deletions(-) create mode 100644 RELEASENOTES.md diff --git a/RELEASENOTES.md b/RELEASENOTES.md new file mode 100644 index 00000000000..ba3ef3e5dc4 --- /dev/null +++ b/RELEASENOTES.md @@ -0,0 +1,9 @@ +# RELEASE NOTES + +## 1.9.0 + +### OpenTelemetry + +* Exemplars are now part of the stable API! For details see: [customizing + exemplars + collection](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#exemplars). diff --git a/src/OpenTelemetry/CHANGELOG.md b/src/OpenTelemetry/CHANGELOG.md index 99fa0384e35..cb336fe070d 100644 --- a/src/OpenTelemetry/CHANGELOG.md +++ b/src/OpenTelemetry/CHANGELOG.md @@ -1,5 +1,8 @@ # Changelog +This file contains individual changes for the OpenTelemetry package. +For highlights and announcements covering all components see: [Release Notes](../../RELEASENOTES.md). + ## Unreleased * Added `OpenTelemetrySdk.Create` API for configuring OpenTelemetry .NET signals @@ -12,11 +15,6 @@ Released 2024-Jun-14 -* Exemplars are now supported as a stable feature. Please note that - Exemplars are disabled by default. Check [OpenTelemetry Metrics - docs](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#exemplars) - to learn how to enable and customize exemplars collection. - ## 1.9.0-rc.1 Released 2024-Jun-07 From 33b7546442362a8477ac4b098649d3b558ba2255 Mon Sep 17 00:00:00 2001 From: Vishwesh Bankwar Date: Wed, 7 Aug 2024 11:16:16 -0700 Subject: [PATCH 4/9] review --- RELEASENOTES.md | 12 +++++++++--- 1 file changed, 9 insertions(+), 3 deletions(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index ba3ef3e5dc4..d2a0f3a512e 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,9 +1,15 @@ # RELEASE NOTES -## 1.9.0 +This file contains highlights and announcements covering all components. +For more details see `CHANGELOG.md` files maintained in the root source +directory of each individual package. -### OpenTelemetry +## 1.9.0 -* Exemplars are now part of the stable API! For details see: [customizing +* `Exemplars` are now part of the stable API! For details see: [customizing exemplars collection](https://github.com/open-telemetry/opentelemetry-dotnet/tree/main/docs/metrics/customizing-the-sdk#exemplars). + +* `WithLogging` is now part of the stable API! Logging, Metrics, and Tracing can + now all be configured using the `With` style and the builders finally have + parity in their APIs. From fd01e08f9492a3d98dae7a8606f3a7f5146048e6 Mon Sep 17 00:00:00 2001 From: Vishwesh Bankwar Date: Wed, 7 Aug 2024 11:18:34 -0700 Subject: [PATCH 5/9] fix --- RELEASENOTES.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index d2a0f3a512e..6aecbfd2d32 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,6 +1,6 @@ # RELEASE NOTES -This file contains highlights and announcements covering all components. +This file contains highlights and announcements covering all components. For more details see `CHANGELOG.md` files maintained in the root source directory of each individual package. From 4d1cef92b0acaf1fbf502724f2eb4f78820abce5 Mon Sep 17 00:00:00 2001 From: Vishwesh Bankwar Date: Wed, 7 Aug 2024 12:29:30 -0700 Subject: [PATCH 6/9] add 1.8.0 and 1.7.0 --- RELEASENOTES.md | 40 +++++++++++++++++++++++++++++++++++++++- 1 file changed, 39 insertions(+), 1 deletion(-) diff --git a/RELEASENOTES.md b/RELEASENOTES.md index 6aecbfd2d32..c19082b772b 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -1,4 +1,4 @@ -# RELEASE NOTES +# Release Notes This file contains highlights and announcements covering all components. For more details see `CHANGELOG.md` files maintained in the root source @@ -13,3 +13,41 @@ directory of each individual package. * `WithLogging` is now part of the stable API! Logging, Metrics, and Tracing can now all be configured using the `With` style and the builders finally have parity in their APIs. + +## 1.8.0 + +* `TracerProvider` sampler can now be configured via the `OTEL_TRACES_SAMPLER` & + `OTEL_TRACES_SAMPLER_ARG` envvars. + +* A new `UseOtlpExporter` cross-cutting extension has been added to register the + `OtlpExporter` and enable all signals in a single call. + +* `exception.type`, `exception.message`, `exception.stacktrace` will now + automatically be included by the `OtlpLogExporter` when logging exceptions. + Previously an experimental environment variable had to be set. + +## 1.7.0 + +* Bumped the package versions of System.Diagnostic.DiagnosticSource and other + Microsoft.Extensions.* packages to `8.0.0`. + +* Added `net8.0` targets to all the components. + +* OTLP Exporter + * Updated to use `ILogger` `CategoryName` as the instrumentation scope for + logs. + * Added named options support for OTLP Log Exporter. + * Added support for instrumentation scope attributes in metrics. + * Added support under an experimental flag to emit log exception attributes. + * Added support under an experimental flag to emit log eventId and eventName. + attributes. + +* Added support for the + [IMetricsBuilder](https://learn.microsoft.com/dotnet/api/microsoft.extensions.diagnostics.metrics.imetricsbuilder) + API. + +* Added an experimental opt-in metrics feature to reclaim unused MetricPoints + which enables a higher number of unique dimension combinations to be emitted. + See [reclaim unused metric + points](https://github.com/open-telemetry/opentelemetry-dotnet/blob/32c64d04defb5c92d056fd8817638151168b10da/docs/metrics/README.md#cardinality-limits) + for more details. From fea558e10586a5f401789c1c3a6d1279e697107c Mon Sep 17 00:00:00 2001 From: Mikel Blanchard Date: Wed, 7 Aug 2024 12:51:11 -0700 Subject: [PATCH 7/9] Tweaks. --- OpenTelemetry.sln | 4 ++++ RELEASENOTES.md | 2 +- build/RELEASING.md | 7 ++++--- 3 files changed, 9 insertions(+), 4 deletions(-) diff --git a/OpenTelemetry.sln b/OpenTelemetry.sln index 61963889e01..4822043231b 100644 --- a/OpenTelemetry.sln +++ b/OpenTelemetry.sln @@ -18,6 +18,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution LICENSE.TXT = LICENSE.TXT NuGet.config = NuGet.config README.md = README.md + RELEASENOTES.md = RELEASENOTES.md THIRD-PARTY-NOTICES.TXT = THIRD-PARTY-NOTICES.TXT VERSIONING.md = VERSIONING.md EndProjectSection @@ -123,6 +124,9 @@ EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Benchmarks", "test\Benchmarks\Benchmarks.csproj", "{DE9130A4-F30A-49D7-8834-41DE3021218B}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{7C87CAF9-79D7-4C26-9FFB-F3F1FB6911F1}" + ProjectSection(SolutionItems) = preProject + docs\README.md = docs\README.md + EndProjectSection EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "examples", "examples", "{2C7DD1DA-C229-4D9E-9AF0-BCD5CD3E4948}" ProjectSection(SolutionItems) = preProject diff --git a/RELEASENOTES.md b/RELEASENOTES.md index c19082b772b..0f1d0b50669 100644 --- a/RELEASENOTES.md +++ b/RELEASENOTES.md @@ -20,7 +20,7 @@ directory of each individual package. `OTEL_TRACES_SAMPLER_ARG` envvars. * A new `UseOtlpExporter` cross-cutting extension has been added to register the - `OtlpExporter` and enable all signals in a single call. + `OtlpExporter` and enable all signals in a single call. * `exception.type`, `exception.message`, `exception.stacktrace` will now automatically be included by the `OtlpLogExporter` when logging exceptions. diff --git a/build/RELEASING.md b/build/RELEASING.md index f9075727bd6..28fdc9a078e 100644 --- a/build/RELEASING.md +++ b/build/RELEASING.md @@ -203,6 +203,7 @@ Maintainers (admins) are needed to merge PRs and for the push to NuGet.** repository which opens a PR to update dependencies. Verify this PR was opened successfully. - 8. Post an announcement in the [Slack - channel](https://cloud-native.slack.com/archives/C01N3BC2W7Q). Note any big - or interesting new features as part of the announcement. + 8. For stable releases, update [Release Notes](../RELEASENOTES.md) with any big + or interesting new features and then post an announcement in the [Slack + channel](https://cloud-native.slack.com/archives/C01N3BC2W7Q) with the same + information. From e876c68a463fc45081f5fbd04f6186eee5a9a33a Mon Sep 17 00:00:00 2001 From: Mikel Blanchard Date: Wed, 7 Aug 2024 12:52:50 -0700 Subject: [PATCH 8/9] Update OpenTelemetry.sln --- OpenTelemetry.sln | 3 --- 1 file changed, 3 deletions(-) diff --git a/OpenTelemetry.sln b/OpenTelemetry.sln index 4822043231b..215994c16e1 100644 --- a/OpenTelemetry.sln +++ b/OpenTelemetry.sln @@ -124,9 +124,6 @@ EndProject Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Benchmarks", "test\Benchmarks\Benchmarks.csproj", "{DE9130A4-F30A-49D7-8834-41DE3021218B}" EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "docs", "docs", "{7C87CAF9-79D7-4C26-9FFB-F3F1FB6911F1}" - ProjectSection(SolutionItems) = preProject - docs\README.md = docs\README.md - EndProjectSection EndProject Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "examples", "examples", "{2C7DD1DA-C229-4D9E-9AF0-BCD5CD3E4948}" ProjectSection(SolutionItems) = preProject From 680eb7d6d87d8b90b5fb41273c715b19dcffe27f Mon Sep 17 00:00:00 2001 From: Mikel Blanchard Date: Wed, 7 Aug 2024 12:58:59 -0700 Subject: [PATCH 9/9] Add link to RELEASENOTES in all CHANGELOGs. --- src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md | 5 +++++ src/OpenTelemetry.Api/CHANGELOG.md | 4 ++++ src/OpenTelemetry.Exporter.Console/CHANGELOG.md | 4 ++++ src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md | 4 ++++ .../CHANGELOG.md | 5 +++++ .../CHANGELOG.md | 5 +++++ .../CHANGELOG.md | 5 +++++ src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md | 4 ++++ src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md | 4 ++++ src/OpenTelemetry.Extensions.Propagators/CHANGELOG.md | 4 ++++ src/OpenTelemetry.Shims.OpenTracing/CHANGELOG.md | 4 ++++ src/OpenTelemetry/CHANGELOG.md | 5 +++-- 12 files changed, 51 insertions(+), 2 deletions(-) diff --git a/src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md b/src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md index fecd873f3a7..6609f3d51c4 100644 --- a/src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md +++ b/src/OpenTelemetry.Api.ProviderBuilderExtensions/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +This file contains individual changes for the +OpenTelemetry.Api.ProviderBuilderExtensions package. For highlights and +announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0 diff --git a/src/OpenTelemetry.Api/CHANGELOG.md b/src/OpenTelemetry.Api/CHANGELOG.md index 54710b1022e..11f7ded10e4 100644 --- a/src/OpenTelemetry.Api/CHANGELOG.md +++ b/src/OpenTelemetry.Api/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Api package. For +highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased * **Breaking change:** CompositeTextMapPropagator.Fields now returns a diff --git a/src/OpenTelemetry.Exporter.Console/CHANGELOG.md b/src/OpenTelemetry.Exporter.Console/CHANGELOG.md index 9e94df266e8..14c7dcb2e5b 100644 --- a/src/OpenTelemetry.Exporter.Console/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.Console/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Exporter.Console +package. For highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0 diff --git a/src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md b/src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md index fc2a00afb3c..9896195900b 100644 --- a/src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.InMemory/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Exporter.InMemory +package. For highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0 diff --git a/src/OpenTelemetry.Exporter.OpenTelemetryProtocol/CHANGELOG.md b/src/OpenTelemetry.Exporter.OpenTelemetryProtocol/CHANGELOG.md index 6c5f736426a..8d5e83d29af 100644 --- a/src/OpenTelemetry.Exporter.OpenTelemetryProtocol/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.OpenTelemetryProtocol/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +This file contains individual changes for the +OpenTelemetry.Exporter.OpenTelemetryProtocol package. For highlights and +announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased * **Breaking change**: Non-primitive attribute (logs) and tag (traces) values diff --git a/src/OpenTelemetry.Exporter.Prometheus.AspNetCore/CHANGELOG.md b/src/OpenTelemetry.Exporter.Prometheus.AspNetCore/CHANGELOG.md index 89392443dac..587692aa805 100644 --- a/src/OpenTelemetry.Exporter.Prometheus.AspNetCore/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.Prometheus.AspNetCore/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +This file contains individual changes for the +OpenTelemetry.Exporter.Prometheus.AspNetCore package. For highlights and +announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0-beta.2 diff --git a/src/OpenTelemetry.Exporter.Prometheus.HttpListener/CHANGELOG.md b/src/OpenTelemetry.Exporter.Prometheus.HttpListener/CHANGELOG.md index d04d8d825b2..1893e205c79 100644 --- a/src/OpenTelemetry.Exporter.Prometheus.HttpListener/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.Prometheus.HttpListener/CHANGELOG.md @@ -1,5 +1,10 @@ # Changelog +This file contains individual changes for the +OpenTelemetry.Exporter.Prometheus.HttpListener package. For highlights and +announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0-beta.2 diff --git a/src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md b/src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md index dedce653992..edf54750adf 100644 --- a/src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md +++ b/src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Exporter.Zipkin +package. For highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased * **Breaking change**: Non-primitive tag values converted using diff --git a/src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md b/src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md index 0b9b1a1c9fe..ac95bbe985e 100644 --- a/src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md +++ b/src/OpenTelemetry.Extensions.Hosting/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Extensions.Hosting +package. For highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0 diff --git a/src/OpenTelemetry.Extensions.Propagators/CHANGELOG.md b/src/OpenTelemetry.Extensions.Propagators/CHANGELOG.md index 10b287b0dc3..aaba4c79496 100644 --- a/src/OpenTelemetry.Extensions.Propagators/CHANGELOG.md +++ b/src/OpenTelemetry.Extensions.Propagators/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the +OpenTelemetry.Extensions.Propagators package. For highlights and announcements +covering all components see: [Release Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0 diff --git a/src/OpenTelemetry.Shims.OpenTracing/CHANGELOG.md b/src/OpenTelemetry.Shims.OpenTracing/CHANGELOG.md index 2d1f86d48d9..68929da6a4e 100644 --- a/src/OpenTelemetry.Shims.OpenTracing/CHANGELOG.md +++ b/src/OpenTelemetry.Shims.OpenTracing/CHANGELOG.md @@ -1,5 +1,9 @@ # Changelog +This file contains individual changes for the OpenTelemetry.Shims.OpenTracing +package. For highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). + ## Unreleased ## 1.9.0-beta.2 diff --git a/src/OpenTelemetry/CHANGELOG.md b/src/OpenTelemetry/CHANGELOG.md index cb336fe070d..844b237e1d2 100644 --- a/src/OpenTelemetry/CHANGELOG.md +++ b/src/OpenTelemetry/CHANGELOG.md @@ -1,7 +1,8 @@ # Changelog -This file contains individual changes for the OpenTelemetry package. -For highlights and announcements covering all components see: [Release Notes](../../RELEASENOTES.md). +This file contains individual changes for the OpenTelemetry package. For +highlights and announcements covering all components see: [Release +Notes](../../RELEASENOTES.md). ## Unreleased