OpenTelemetry.Exporter.Zipkin 1.13.0

Prefix Reserved

.NET 8.0 .NET Standard 2.0 .NET Framework 4.6.2

This package has been deprecated as it has critical bugs.

Additional Details

This version omitted Sigstore verification artifacts (`.dll-keyless.sig` / `.dll-keyless.pem`). Use 1.13.1 or later.

There is a newer version of this package available.
See the version list below for details.

dotnet add package OpenTelemetry.Exporter.Zipkin --version 1.13.0

NuGet\Install-Package OpenTelemetry.Exporter.Zipkin -Version 1.13.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="OpenTelemetry.Exporter.Zipkin" Version="1.13.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="OpenTelemetry.Exporter.Zipkin" Version="1.13.0" />
                    

                            Directory.Packages.props

<PackageReference Include="OpenTelemetry.Exporter.Zipkin" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add OpenTelemetry.Exporter.Zipkin --version 1.13.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: OpenTelemetry.Exporter.Zipkin, 1.13.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package OpenTelemetry.Exporter.Zipkin@1.13.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=OpenTelemetry.Exporter.Zipkin&version=1.13.0
                    

                            Install as a Cake Addin

#tool nuget:?package=OpenTelemetry.Exporter.Zipkin&version=1.13.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Zipkin Exporter for OpenTelemetry .NET

Prerequisite

Get Zipkin

Installation

dotnet add package OpenTelemetry.Exporter.Zipkin

Enable/Add Zipkin as a tracing exporter

You can enable the ZipkinExporter with the AddZipkinExporter() extension method on TracerProviderBuilder.

Configuration

You can configure the ZipkinExporter through ZipkinExporterOptions and environment variables. The ZipkinExporterOptions setters take precedence over the environment variables.

Configuration using Properties

BatchExportProcessorOptions: Configuration options for the batch exporter. Only used if ExportProcessorType is set to Batch.
Endpoint: URI address to receive telemetry (default http://localhost:9411/api/v2/spans).
ExportProcessorType: Whether the exporter should use Batch or Simple exporting processor.
HttpClientFactory: A factory function called to create the HttpClient instance that will be used at runtime to transmit spans over HTTP. See Configure HttpClient for more details.
MaxPayloadSizeInBytes: Maximum payload size of UTF8 JSON chunks sent to Zipkin (default 4096).
ServiceName: Name of the service reporting telemetry. If the Resource associated with the telemetry has "service.name" defined, then it'll be preferred over this option.
UseShortTraceIds: Whether the trace's ID should be shortened before sending to Zipkin (default false).

See TestZipkinExporter.cs for example use.

Configuration using Dependency Injection

This exporter allows easy configuration of ZipkinExporterOptions from dependency injection container, when used in conjunction with OpenTelemetry.Extensions.Hosting.

See the Startup class of the ASP.NET Core application for example use.

Configuration using Environment Variables

The following environment variables can be used to override the default values of the ZipkinExporterOptions.

Environment variable	`ZipkinExporterOptions` property
`OTEL_EXPORTER_ZIPKIN_ENDPOINT`	`Endpoint`

Configure HttpClient

The HttpClientFactory option is provided on ZipkinExporterOptions for users who want to configure the HttpClient used by the ZipkinExporter. Simply replace the function with your own implementation if you want to customize the generated HttpClient:

services.AddOpenTelemetry()
    .WithTracing(builder => builder
        .AddZipkinExporter(o => o.HttpClientFactory = () =>
        {
            HttpClient client = new HttpClient();
            client.DefaultRequestHeaders.Add("X-MyCustomHeader", "value");
            return client;
        }));

For users using IHttpClientFactory you may also customize the named "ZipkinExporter" HttpClient using the built-in AddHttpClient extension:

services.AddHttpClient(
    "ZipkinExporter",
     configureClient: (client) =>
        client.DefaultRequestHeaders.Add("X-MyCustomHeader", "value"));

Note: The single instance returned by HttpClientFactory is reused by all export requests.

Troubleshooting

This component uses an EventSource with the name "OpenTelemetry-Exporter-Zipkin" for its internal logging. Please refer to SDK troubleshooting for instructions on seeing these internal logs.

References

Product	Compatible and additional computed target framework versions.
.NET	net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.
.NET Core	netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed.
.NET Standard	netstandard2.0 is compatible. netstandard2.1 was computed.
.NET Framework	net461 was computed. net462 is compatible. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed.
MonoAndroid	monoandroid was computed.
MonoMac	monomac was computed.
MonoTouch	monotouch was computed.
Tizen	tizen40 was computed. tizen60 was computed.
Xamarin.iOS	xamarinios was computed.
Xamarin.Mac	xamarinmac was computed.
Xamarin.TVOS	xamarintvos was computed.
Xamarin.WatchOS	xamarinwatchos was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

.NETFramework 4.6.2
- OpenTelemetry (>= 1.13.0)
- System.Text.Encodings.Web (>= 4.7.2)
- System.Text.Json (>= 4.7.2)
.NETStandard 2.0
- OpenTelemetry (>= 1.13.0)
- System.Text.Encodings.Web (>= 4.7.2)
- System.Text.Json (>= 4.7.2)
net8.0
- OpenTelemetry (>= 1.13.0)
- System.Text.Json (>= 8.0.5)
net9.0
- OpenTelemetry (>= 1.13.0)

NuGet packages (64)

Showing the top 5 NuGet packages that depend on OpenTelemetry.Exporter.Zipkin:

Package	Downloads
OpenTelemetry.AutoInstrumentation.Runtime.Managed Managed components used by the OpenTelemetry.AutoInstrumentation project.	3.5M
MyJetWallet.Sdk.Service Package Description	537.8K
devprime.stack.observability DevPrime Observability	250.4K
FCMicroservices a boilerplate microservice framework	41.1K
Cszy.OpenTelemetry.AspNetCore Cszy.OpenTelemetry.AspNetCore是Cszy应用框架对OpenTelemetry.AspNetCore的封装	40.0K

GitHub repositories (26)

Showing the top 20 popular GitHub repositories that depend on OpenTelemetry.Exporter.Zipkin:

Repository	Stars
dotnet/tye Tye is a tool that makes developing, testing, and deploying microservices and distributed applications easier. Project Tye includes a local orchestrator to make developing microservices easier and the ability to deploy microservices to Kubernetes with minimal configuration.	5.2K
grpc/grpc-dotnet gRPC for .NET	4.4K
dotnet/samples Sample code referenced by the .NET documentation	3.6K
Squidex/squidex Headless CMS and Content Managment Hub	2.5K
phongnguyend/Practical.CleanArchitecture Full-stack .Net 9 Clean Architecture (Microservices, Modular Monolith, Monolith), Blazor, Angular 20, React 19, Vue 3.5, BFF with YARP, NextJs 15, Domain-Driven Design, CQRS, SOLID, Asp.Net Core Identity Custom Storage, OpenID Connect, EF Core, OpenTelemetry, SignalR, Background Services, Health Checks, Rate Limiting, Clouds (Azure, AWS, GCP), ..	2.4K
Azure/durabletask Durable Task Framework allows users to write long running persistent workflows in C# using the async/await capabilities.	1.7K
thangchung/clean-architecture-dotnet 🕸 Yet Another .NET Clean Architecture, but for Microservices project. It uses Minimal Clean Architecture with DDD-lite, CQRS-lite, and just enough Cloud-native patterns apply on the simple eCommerce sample and run on Tye with Dapr extension 🍻	1.3K
meysamhadeli/booking-microservices A practical microservices with the latest technologies and architectures like Vertical Slice Architecture, Event Sourcing, CQRS, DDD, gRpc, MongoDB, RabbitMq, Masstransit, and Aspire in .Net 9.	1.3K
colinin/abp-next-admin 这是基于vue-vben-admin 模板适用于abp vNext的前端管理项目	950
mehdihadeli/food-delivery-microservices 🍔 A practical and cloud-native food delivery microservices, built with .Net Aspire, .Net 9, MassTransit, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.	943
MUnique/OpenMU This project aims to create an easy to use, extendable and customizable server for a MMORPG called "MU Online".	889
b-editor/beutl Cross-platform video editing (compositing) software.	886
davidfowl/Micronetes Micronetes is a local orchestrator inspired by kubernetes that makes developing and testing microservices and distributed applications easier.	772
Aguafrommars/TheIdServer OpenID/Connect, OAuth2, WS-Federation and SAML 2.0 server based on Duende IdentityServer and ITFoxtec Identity SAML 2.0 with its admin UI	746
SteeltoeOSS/Samples Steeltoe samples and reference application collection	647
open-telemetry/opentelemetry-dotnet-contrib This repository contains set of components extending functionality of the OpenTelemetry .NET SDK. Instrumentation libraries, exporters, and other components can find their home here.	606
Eventuous/eventuous Event Sourcing library for .NET	493
meysamhadeli/booking-modular-monolith A practical Modular Monolith architecture with the latest technologies and architecture like Vertical Slice Architecture, Event Driven Architecture, CQRS, DDD, gRpc, Masstransit, and Aspire in .Net 9.	415
mehdihadeli/vertical-slice-api-template 🍰 An asp.net core template based on .Net 9, Vertical Slice Architecture, CQRS, Minimal APIs, OpenTelemetry, API Versioning and OpenAPI.	244
newbe36524/Newbe.Claptrap This is a frameworks with reactive, event sourcing and Actor pattern as basic theories. On top of this, developers can create "distributed", "scale out", and "easy to test" application more simply. Claptrap and it`s Minions is on the way.	214

Version	Downloads	Last Updated
1.14.0-rc.1	160	10/21/2025
1.13.1	26,854	10/9/2025
1.13.0	15,863	10/1/2025
1.12.0	1,020,091	4/30/2025
1.11.2	776,262	3/4/2025
1.11.1	411,273	1/23/2025
1.11.0	203,165	1/16/2025
1.11.0-rc.1	995	12/12/2024
1.10.0	329,568	11/12/2024
1.10.0-rc.1	1,472	11/1/2024
1.10.0-beta.1	3,824	9/30/2024
1.9.0	2,714,024	6/14/2024
1.9.0-rc.1	205	6/7/2024
1.9.0-alpha.1	1,178	5/20/2024
1.8.1	969,533	4/18/2024
1.8.0	387,277	4/3/2024
1.8.0-rc.1	319	3/27/2024
1.8.0-beta.1	5,354	3/14/2024
1.7.0	1,234,049	12/9/2023
1.7.0-rc.1	5,564	11/30/2023
1.7.0-alpha.1	11,169	10/17/2023
1.6.0	1,219,445	9/6/2023
1.6.0-rc.1	8,359	8/21/2023
1.6.0-alpha.1	15,144	7/12/2023
1.5.1	1,062,131	6/26/2023
1.5.0	91,541	6/6/2023
1.5.0-rc.1	3,506	5/26/2023
1.5.0-alpha.2	68,391	4/1/2023
1.5.0-alpha.1	5,047	3/8/2023
1.4.0	712,652	2/24/2023
1.4.0-rc.4	27,387	2/11/2023
1.4.0-rc.3	12,902	2/2/2023
1.4.0-rc.2	24,611	1/9/2023
1.4.0-rc.1	31,760	12/12/2022
1.4.0-beta.3	87,463	11/7/2022
1.4.0-beta.2	42,266	10/17/2022
1.4.0-beta.1	20,791	9/30/2022
1.4.0-alpha.2	44,575	8/18/2022
1.4.0-alpha.1	64,863	8/3/2022
1.3.2	430,600	12/20/2022
1.3.1	634,208	9/8/2022
1.3.0	808,597	6/3/2022
1.3.0-rc.2	1,094	6/1/2022
1.3.0-beta.2	8,457	5/17/2022
1.3.0-beta.1	9,878	4/20/2022
1.2.0	1,348,418	4/15/2022
1.2.0-rc5	3,181	4/13/2022
1.2.0-rc4	9,237	3/30/2022
1.2.0-rc3	88,431	3/5/2022
1.2.0-rc2	92,691	2/3/2022
1.2.0-rc1	309,624	11/30/2021
1.2.0-beta2.1	100,902	11/19/2021
1.2.0-beta1	289,075	10/8/2021
1.2.0-alpha4	33,016	9/23/2021
1.2.0-alpha3	2,753	9/14/2021
1.2.0-alpha2	9,412	8/25/2021
1.1.0	566,070	7/13/2021
1.1.0-rc1	6,217	6/26/2021
1.1.0-beta4	6,887	6/9/2021
1.1.0-beta3	1,987	5/12/2021
1.1.0-beta2	26,030	4/23/2021
1.1.0-beta1	88,996	3/19/2021
1.0.1	294,433	2/10/2021
1.0.0-rc4	10,744	2/9/2021
1.0.0-rc3	1,519	2/5/2021
1.0.0-rc2	7,387	1/30/2021
1.0.0-rc1.1	178,990	11/18/2020
0.8.0-beta.1	8,851	11/5/2020
0.7.0-beta.1	2,146	10/16/2020
0.6.0-beta.1	14,160	9/16/2020
0.5.0-beta.2	1,974	8/28/2020
0.4.0-beta.2	41,858	7/25/2020
0.3.0-beta.1	1,654	7/23/2020
0.2.0-alpha.275	163,561	5/19/2020
0.2.0-alpha.220	455,046	5/19/2020
0.2.0-alpha.179	65,257	1/28/2020
0.2.0-alpha.100	12,721	11/5/2019
0.2.0-alpha.40	530	9/24/2019
0.2.0-alpha.5	736	8/3/2019

For highlights and announcements see: https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.13.0/RELEASENOTES.md.

For detailed changes see: https://github.com/open-telemetry/opentelemetry-dotnet/blob/core-1.13.0/src/OpenTelemetry.Exporter.Zipkin/CHANGELOG.md.