This file contains individual changes for the OpenTelemetry.Exporter.Zipkin package. For highlights and announcements covering all components see: Release Notes.
Released 2026-Jan-21
- This package is deprecated and it will stop receiving any updates in
December 2026. Zipkin already supports OTLP ingestion. Change your exporter
to
OpenTelemetry.Exporter.OpenTelemetryProtocolas stated in the Deprecating Zipkin Exporter blog post. (#6750)
Released 2025-Nov-12
- Breaking Change NuGet packages now use the Sigstore bundle format
(
.sigstore.json) for digital signatures instead of separate signature (.sig) and certificate (.pem) files. This requires cosign 3.0 or later for verification. See the Digital signing section for updated verification instructions. (#6623)
Released 2025-Oct-21
-
Breaking Change When targeting
net8.0, the package now depends on version8.0.0of theMicrosoft.Extensions.DependencyInjection.Abstractions,Microsoft.Extensions.Diagnostics.AbstractionsandMicrosoft.Extensions.Logging.ConfigurationNuGet packages. (#6327) -
Add support for .NET 10.0. (#6307)
Released 2025-Oct-09
Released 2025-Oct-01
-
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. (#6191)
-
Extended remote endpoint calculation to align with the opentelemetry-specification. (#6191)
Released 2025-Apr-29
Released 2025-Mar-04
Released 2025-Jan-22
Released 2025-Jan-15
Released 2024-Dec-11
Released 2024-Nov-12
Released 2024-Nov-01
- Added direct reference to
System.Text.Jsonfor thenet8.0target with minimum version of8.0.5in response to CVE-2024-30105 & CVE-2024-43485. (#5874, #5891)
Released 2024-Sep-30
-
Breaking change: Non-primitive tag values converted using
Convert.ToStringwill now format usingCultureInfo.InvariantCulture. (#5700) -
Fixed
PlatformNotSupportedExceptions being thrown during export when running on mobile platforms which caused telemetry to be dropped silently. (#5821)
Released 2024-Jun-14
Released 2024-Jun-07
Released 2024-May-20
Released 2024-Apr-17
Released 2024-Apr-02
Released 2024-Mar-27
- Zipkin tags used for Instrumentation Library changed from
otel.library.nameandotel.library.versiontootel.scope.nameandotel.scope.versionrespectively. Old versions of attributes are deprecated, but still exported for backward compatibility. (#5473)
Released 2024-Mar-14
Released 2023-Dec-08
Released 2023-Nov-29
Released 2023-Oct-16
Released 2023-Sep-05
Released 2023-Aug-21
Released 2023-Jul-12
Released 2023-Jun-26
Released 2023-Jun-05
Released 2023-May-25
- Added direct reference to
System.Text.Encodings.Webwith minimum version of4.7.2in response to CVE-2021-26701.
Released 2023-Mar-31
Released 2023-Mar-07
Released 2023-Feb-24
- Updated OTel SDK dependency to 1.4.0
Released 2023-Feb-10
Released 2023-Feb-01
- Changed EnvironmentVariable parsing to not throw a
FormatExceptionand instead log a warning. (#4095)
Released 2023-Jan-09
Released 2022-Dec-12
Released 2022-Nov-07
- Bumped the minimum required version of
System.Text.Jsonto 4.7.2 in response to CVE-2021-26701. (#3789)
Released 2022-Oct-17
- Added support for loading environment variables from
IConfigurationwhen using theAddZipkinExporterextension (#3759)
Released 2022-Sep-29
- Added overloads which accept a name to the
TracerProviderBuilderAddZipkinExporterextension to allow for more fine-grained options management (#3655)
Released 2022-Aug-18
Released 2022-Aug-02
Released 2022-Jun-03
Released 2022-June-1
- Improve the conversion and formatting of attribute values.
The list of data types that must be supported per the
OpenTelemetry specification
is more narrow than what the .NET OpenTelemetry SDK supports. Numeric
built-in value types
are supported by converting to a
longordoubleas appropriate except for numeric types that could cause overflow (ulong) or rounding (decimal) which are converted to strings. Non-numeric built-in types -string,char,boolare supported. All other types are converted to astring. Array values are also supported. (#3281) - Fix conversion of array-valued resource attributes. They were previously converted to a string like "System.String[]". (#3281)
- Fix exporting of array-valued attributes on an
Activity. Previously, each item in the array would result in a new tag on an exportedActivity. Now, array-valued attributes are serialized to a JSON-array representation. (#3281)
Released 2022-May-16
- Removes net5.0 target and replaced with net6.0 as .NET 5.0 is going out of support. The package keeps netstandard2.0 target, so it can still be used with .NET5.0 apps. (#3147)
Released 2022-Apr-15
- Removes .NET Framework 4.6.1. The minimum .NET Framework version supported is .NET 4.6.2. (#3190)
Released 2022-Apr-15
Released 2022-Apr-12
Released 2022-Mar-30
- Added support for Activity Status and StatusDescription which were
added to Activity from
System.Diagnostics.DiagnosticSourceversion 6.0. Prior to version 6.0, setting the status of an Activity was provided by the .NET OpenTelemetry API via theActivity.SetStatusextension method in theOpenTelemetry.Tracenamespace. Internally, this extension method added the status as tags on the Activity:otel.status_codeandotel.status_description. Therefore, to maintain backward compatibility, the exporter falls back to using these tags to infer status. (#3003)
Released 2022-Mar-04
- Modified Export method to catch all exceptions. (#2935)
Released 2022-Feb-02
Released 2021-Nov-29
Released 2021-Nov-19
-
Changed
ZipkinExporterOptionsconstructor to throwFormatExceptionif it fails to parse any of the supported environment variables. -
Added
HttpClientFactoryoption (#2654)
Released 2021-Oct-08
- Added .NET 5.0 target and threading optimizations (#2405)
Released 2021-Sep-23
Released 2021-Sep-13
ZipkinExporterOptions.BatchExportProcessorOptionsis initialized withBatchExportActivityProcessorOptionswhich supports field value overriding usingOTEL_BSP_SCHEDULE_DELAY,OTEL_BSP_EXPORT_TIMEOUT,OTEL_BSP_MAX_QUEUE_SIZE,OTEL_BSP_MAX_EXPORT_BATCH_SIZEenvironmental variables as defined in the specification. (#2219)
Released 2021-Aug-24
- Enabling endpoint configuration in ZipkinExporterOptions via
OTEL_EXPORTER_ZIPKIN_ENDPOINTenvironment variable. (#1453)
Released 2021-Jul-23
- Removes .NET Framework 4.5.2, .NET 4.6 support. The minimum .NET Framework version supported is .NET 4.6.1. (#2138)
Released 2021-Jul-12
Released 2021-Jun-25
Released 2021-Jun-09
Released 2021-May-11
Released 2021-Apr-23
- When using OpenTelemetry.Extensions.Hosting you can now bind
ZipkinExporterOptionstoIConfigurationusing theConfigureextension (ex:services.Configure<ZipkinExporterOptions>(this.Configuration.GetSection("Zipkin"));). (#1889)
Released 2021-Mar-19
Released 2021-Feb-10
Released 2021-Feb-09
Released 2021-Feb-04
- Moved
ZipkinExporterandZipkinExporterOptionsclasses toOpenTelemetry.Exporternamespace. (#1770) - Removes ability to configure ServiceName for Zipkin. ServiceName must come via Resource. If service name is not found in Resource, Zipkin uses GetDefaultResource() from the SDK to obtain it. #1768
Released 2021-Jan-29
-
Changed
ZipkinExporterclass and constructor from internal to public. (#1612) -
Zipkin will now set the
errortag to theStatus.Descriptionvalue or an empty string whenStatus.StatusCode(otel.status_codetag) is set toERROR. (#1579 #1620 #1655) -
Zipkin will no longer send the
otel.status_codetag if the value isUNSET. (#1609 #1620) -
Zipkin bool tag values will now be sent as
true/falseinstead ofTrue/False. (#1609) -
Span tags will no longer be populated with Resource Attributes. (#1663)
-
Spans will no longer be held in memory indefinitely when
ZipkinExportercannot connect to the configured endpoint. (#1726)
Released 2020-Nov-17
- Added ExportProcessorType to exporter options (#1504)
- Zipkin tags used for InstrumentationLibrary changed from library.name, library.version to otel.library.name, otel.library.version respectively.
- Sending
service.namespaceas Zipkin tag. (#1521) - The
ZipkinExporterclass has been made internal. (#1540)
Released 2020-Nov-5
- ZipkinExporter will now respect global Resource set via
TracerProviderBuilder.SetResource. (#1385)
Released 2020-Oct-16
- Removed unused
TimeoutSecondsand addedMaxPayloadSizeInBytesonZipkinExporterOptions. The default value forMaxPayloadSizeInBytesis 4096. (#1247)
Released 2020-Sep-15
Released 2020-08-28
- Renamed extension method from
UseZipkinExportertoAddZipkinExporter. (#1066) - Changed
ZipkinExporterto useBatchExportActivityProcessorby default. (#1103) - Fixed issue when span has both the
net.peer.nameandnet.peer.portattributes but did not includenet.peer.portin the service address field. (#1168)
Released 2020-07-24
- First beta release
Released 2020-07-23
- Initial release