core-1.11.0

For highlights and announcements pertaining to this release see: Release Notes > 1.11.0.

The following changes are from the previous release 1.11.0-rc.1.

• NuGet: OpenTelemetry v1.11.0

  • Meter.Tags
    will now be considered when resolving the SDK metric to update when
    measurements are recorded. Meters with the same name and different tags will
    now lead to unique metrics.
    (#5982)

  • Fixed a bug in tracing where TraceState set by a custom Sampler is not
    applied when creating propagation-only spans.
    (#6058)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.11.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.11.0

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.11.0-beta.1

The following changes are from the previous release 1.10.0-beta.1.

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.11.0-beta.1

  • Updated OpenTelemetry core component version(s) to 1.11.0.
    (#6064)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.11.0-beta.1

  • Updated OpenTelemetry core component version(s) to 1.11.0.
    (#6064)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.11.0-beta.1

  • Updated OpenTelemetry core component version(s) to 1.11.0.
    (#6064)

  See CHANGELOG for details.

core-1.11.0-rc.1

The following changes are from the previous release 1.10.0.

• NuGet: OpenTelemetry v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.11.0-rc.1

  • Removed the following package references:

    • Google.Protobuf
    • Grpc
    • Grpc.Net.Client

    These changes were made to streamline dependencies and reduce the footprint of
    the exporter.
    (#6005)

  • Switched from using the Google.Protobuf library for serialization to a
    custom manual implementation of protobuf serialization.
    (#6005)

  • Fixed an issue where a service.name was added to the resource if it was
    missing. The exporter now respects the resource data provided by the SDK
    without modifications.
    (#6015)

  • Removed the peer service resolver, which was based on earlier experimental
    semantic conventions that are not part of the stable specification. This
    change ensures that the exporter no longer modifies or assumes the value of
    peer service attributes, aligning it more closely with OpenTelemetry protocol
    specifications.
    (#6005)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.11.0-rc.1

  No notable changes.

  See CHANGELOG for details.

core-1.10.0

For highlights and announcements pertaining to this release see: Release Notes > 1.10.0.

The following changes are from the previous release 1.10.0-rc.1.

• NuGet: OpenTelemetry v1.10.0

  • Promoted the MetricPoint reclaim feature for Delta aggregation temporality
    from experimental to stable.
    (#5956)

    Previous Behavior:
    The SDK maintained a fixed set of MetricPoints which were assigned on a
    first-come basis based on the tags. MetricPoint reclaim was an experimental
    feature users could opt-into setting the environment variable
    OTEL_DOTNET_EXPERIMENTAL_METRICS_RECLAIM_UNUSED_METRIC_POINTS=true.

    New Behavior:
    MetricPoint reclaim is now enabled by default when Delta aggregation
    temporality is used without the need to set an environment variable. Unused
    MetricPoints will automatically be reclaimed and reused for future
    measurements. There is NO ability to revert to the old behavior.

  • Updated the Microsoft.Extensions.Logging.Configuration and
    Microsoft.Extensions.Diagnostics.Abstractions package versions to
    9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0

  • Updated System.Diagnostics.DiagnosticSource package version to
    9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0

  • Updated Microsoft.Extensions.DependencyInjection.Abstractions package
    version to 9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0.
    (#5967)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.10.0-beta.1

The following changes are from the previous release 1.9.0-beta.2.

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.10.0-beta.1

  • Added meter-level tags to Prometheus exporter
    (#5837)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.10.0-beta.1

  • Added meter-level tags to Prometheus exporter
    (#5837)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.10.0-beta.1

  • Fixed an issue causing all tag values added via the ISpanBuilder API to be
    converted to strings on the ISpan started from the builder.
    (#5797)

  • Updated OpenTelemetry core component version(s) to 1.10.0.
    (#5970)

  See CHANGELOG for details.

core-1.10.0-rc.1

The following changes are from the previous release 1.10.0-beta.1.

• NuGet: OpenTelemetry v1.10.0-rc.1

  • The experimental APIs previously covered by OTEL1003
    (MetricStreamConfiguration.CardinalityLimit) are now part of the public API
    and supported in stable builds.
    (#5926)

  • Promoted overflow attribute from experimental to stable and removed the
    OTEL_DOTNET_EXPERIMENTAL_METRICS_EMIT_OVERFLOW_ATTRIBUTE environment variable.

    Previous Behavior:
    By default, when the cardinality limit was reached, measurements were dropped,
    and an internal log was emitted the first time this occurred. Users could
    opt-in to experimental overflow attribute feature with
    OTEL_DOTNET_EXPERIMENTAL_METRICS_EMIT_OVERFLOW_ATTRIBUTE=true.
    With this setting, the SDK would use an overflow attribute
    (otel.metric.overflow = true) to aggregate measurements instead of dropping
    measurements. No internal log was emitted in this case.

    New Behavior:
    The SDK now always uses the overflow attribute (otel.metric.overflow = true)
    to aggregate measurements when the cardinality limit is reached. The previous
    approach of dropping measurements has been removed. No internal logs are
    emitted when the limit is hit.

    The default cardinality limit remains 2000 per metric. To set the cardinality
    limit for an individual metric, use the changing cardinality limit for a
    Metric.

    There is NO ability to revert to old behavior.
    (#5909)

  • Exposed a public constructor on Batch<T> which accepts a single instance
    of T to be contained in the batch.
    (#5642)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0-rc.1

  • Added direct reference to System.Text.Json for the net8.0 target with
    minimum version of 8.0.5 in response to
    CVE-2024-30105 &
    CVE-2024-43485.
    (#5874,
    #5891)

  • Added support for Instrumentation Scope Attributes (i.e
    ActivitySource.Tags)
    when writing traces to the console.
    (#5935)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0-rc.1

  • Added support for exporting instrumentation scope attributes from
    ActivitySource.Tags.
    (#5897)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0-rc.1

  • Added direct reference to System.Text.Json for the net8.0 target with
    minimum version of 8.0.5 in response to
    CVE-2024-30105 &
    CVE-2024-43485.
    (#5874,
    #5891)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0-rc.1

  No notable changes.

  See CHANGELOG for details.

core-1.10.0-beta.1

The following changes are from the previous release 1.9.0.

• NuGet: OpenTelemetry v1.10.0-beta.1

  • Added OpenTelemetrySdk.Create API for configuring OpenTelemetry .NET signals
    (logging, tracing, and metrics) via a single builder. This new API simplifies
    bootstrap and teardown, and supports cross-cutting extensions targeting
    IOpenTelemetryBuilder.
    (#5325)

  • Updated the Microsoft.Extensions.Logging.Configuration and
    Microsoft.Extensions.Diagnostics.Abstractions packages version to
    9.0.0-rc.1.24431.7.
    (#5853)

  • Added support in metrics for histogram bucket boundaries set via the .NET 9
    InstrumentAdvice<T>
    API.

    Note: With this change explicit bucket histogram boundary resolution will
    apply in the following order:

    1. View API
    2. Advice API
    3. SDK defaults

    See #5854
    for details.

  • Added support for collecting metrics emitted via the .NET 9
    Gauge<T>
    API.
    (#5867)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.10.0-beta.1

  • Breaking change: CompositeTextMapPropagator.Fields now returns a
    unioned set of fields from all combined propagators. Previously this always
    returned an empty set.
    (#5745)

  • Optimize performance of TraceContextPropagator.Extract.
    (#5749)

  • Obsoleted the ActivityExtensions.GetStatus and
    ActivityExtensions.SetStatus extension methods. Users should migrate to the
    System.Diagnostics.DiagnosticSource
    Activity.SetStatus
    API for setting the status and
    Activity.Status
    &
    Activity.StatusDescription
    APIs for reading the status of an Activity instance.
    (#5781)

  • Updated System.Diagnostics.DiagnosticSource package version to
    9.0.0-rc.1.24431.7.
    (#5853)

  • Obsoleted the ActivityExtensions.RecordException extension method. Users
    should migrate to the System.Diagnostics.DiagnosticSource
    Activity.AddException
    API for adding exceptions on an Activity instance.
    (#5841)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.10.0-beta.1

  • Updated Microsoft.Extensions.DependencyInjection.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.10.0-beta.1

  • Breaking change: Non-primitive attribute (logs) and tag (traces) values
    converted using Convert.ToString will now format using
    CultureInfo.InvariantCulture.
    (#5700)

  • Fixed an issue causing NotSupportedExceptions to be thrown on startup when
    AddOtlpExporter registration extensions are called while using custom
    dependency injection containers which automatically create services (Unity,
    Grace, etc.).
    (#5808)

    • Fixed PlatformNotSupportedExceptions being thrown during export when running
      on mobile platforms which caused telemetry to be dropped silently.
      (#5821)

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.10.0-beta.1

  • Breaking change: Non-primitive tag values converted using
    Convert.ToString will now format using CultureInfo.InvariantCulture.
    (#5700)

  • Fixed PlatformNotSupportedExceptions being thrown during export when running
    on mobile platforms which caused telemetry to be dropped silently.
    (#5821)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.10.0-beta.1

  • Updated Microsoft.Extensions.Hosting.Abstractions package
    version to 9.0.0-rc.1.24431.7.
    (#5853)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.10.0-beta.1

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-beta.2

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-beta.2

  • Fixed a bug which lead to empty responses when the internal buffer is resized
    processing a collection request
    (#5676)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-beta.2

  • Fixed a bug which lead to empty responses when the internal buffer is resized
    processing a collection request
    (#5676)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-beta.2

  No notable changes.

  See CHANGELOG for details.

core-1.9.0

For highlights and announcements pertaining to this release see: Release Notes > 1.9.0.

The following changes are from the previous release 1.9.0-rc.1.

• NuGet: OpenTelemetry v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api v1.9.0

  • Breaking change: Revert space character encoding change from + to %20
    for baggage item values from #5303
    (#5687)

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Api.ProviderBuilderExtensions v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Console v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.InMemory v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.OpenTelemetryProtocol v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Zipkin v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Hosting v1.9.0

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Extensions.Propagators v1.9.0

  No notable changes.

  See CHANGELOG for details.

coreunstable-1.9.0-beta.1

• NuGet: OpenTelemetry.Exporter.Prometheus.AspNetCore v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Exporter.Prometheus.HttpListener v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.

• NuGet: OpenTelemetry.Shims.OpenTracing v1.9.0-beta.1

  No notable changes.

  See CHANGELOG for details.