Deprecate Zipkin exporter (#4681)

Kielek · web-flow · commit c1dd1ea690c4 · 2025-12-08T07:58:23.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -27,6 +27,7 @@ This component adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.h
 ### Deprecated
 
 - Deprecate support for `OpenTracing`.
+- Deprecate support for Zipkin exporter. Use OTLP exporter instead.
 
 ### Removed
 
diff --git a/docs/config.md b/docs/config.md
@@ -283,10 +283,12 @@ Exporters output the telemetry.
 
 | Environment variable    | Description                                                                                                                                                                                                                                                                                                    | Default value | Status                                                                                                                      |
 |-------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------|-----------------------------------------------------------------------------------------------------------------------------|
-| `OTEL_TRACES_EXPORTER`  | Comma-separated list of exporters. Supported options: `otlp`, `zipkin`, `console`, `none`. See [the OpenTelemetry specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.35.0/specification/configuration/sdk-environment-variables.md#exporter-selection) for more details.     | `otlp`        | [Stable](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/versioning-and-stability.md) |
+| `OTEL_TRACES_EXPORTER`  | Comma-separated list of exporters. Supported options: `otlp`, `zipkin` [1], `console`, `none`. See [the OpenTelemetry specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.35.0/specification/configuration/sdk-environment-variables.md#exporter-selection) for more details. | `otlp`        | [Stable](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/versioning-and-stability.md) |
 | `OTEL_METRICS_EXPORTER` | Comma-separated list of exporters. Supported options: `otlp`, `prometheus`, `console`, `none`. See [the OpenTelemetry specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.35.0/specification/configuration/sdk-environment-variables.md#exporter-selection) for more details. | `otlp`        | [Stable](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/versioning-and-stability.md) |
 | `OTEL_LOGS_EXPORTER`    | Comma-separated list of exporters. Supported options: `otlp`, `console`, `none`. See [the OpenTelemetry specification](https://github.com/open-telemetry/opentelemetry-specification/blob/v1.35.0/specification/configuration/sdk-environment-variables.md#exporter-selection) for more details.               | `otlp`        | [Stable](https://github.com/open-telemetry/opentelemetry-specification/blob/main/specification/versioning-and-stability.md) |
 
+**[1]**: `zipkin` is deprecated and will be removed in the upcoming release.
+
 ### Traces exporter
 
 | Environment variable             | Description                                                                  | Default value | Status                                                                                                                      |
diff --git a/docs/file-based-configuration.md b/docs/file-based-configuration.md
@@ -196,6 +196,7 @@ tracer_provider:
             # On .NET Framework, the grpc OTLP exporter protocol is not supported.
 
     # Batch processor for Zipkin
+    # This configuration is deprecated and will be removed in upcoming release.
     - batch:
         exporter:
           zipkin:
diff --git a/docs/plugins.md b/docs/plugins.md
@@ -115,7 +115,7 @@ public class MyPlugin
 | Options type                                                                              | NuGet package                                     | NuGet version |
 |-------------------------------------------------------------------------------------------|---------------------------------------------------|---------------|
 | OpenTelemetry.Exporter.ConsoleExporterOptions                                             | OpenTelemetry.Exporter.Console                    | 1.14.0        |
-| OpenTelemetry.Exporter.ZipkinExporterOptions                                              | OpenTelemetry.Exporter.Zipkin                     | 1.14.0        |
+| OpenTelemetry.Exporter.ZipkinExporterOptions  **Deprecated**                              | OpenTelemetry.Exporter.Zipkin                     | 1.14.0        |
 | OpenTelemetry.Exporter.OtlpExporterOptions                                                | OpenTelemetry.Exporter.OpenTelemetryProtocol      | 1.14.0        |
 | OpenTelemetry.Instrumentation.AspNet.AspNetTraceInstrumentationOptions                    | OpenTelemetry.Instrumentation.AspNet              | 1.14.0        |
 | OpenTelemetry.Instrumentation.AspNetCore.AspNetCoreTraceInstrumentationOptions            | OpenTelemetry.Instrumentation.AspNetCore          | 1.14.0        |
diff --git a/src/OpenTelemetry.AutoInstrumentation/Configurations/EnvironmentConfigurationTracerHelper.cs b/src/OpenTelemetry.AutoInstrumentation/Configurations/EnvironmentConfigurationTracerHelper.cs
@@ -368,6 +368,7 @@ public static TracerProviderBuilder AddConsoleExporter(TracerProviderBuilder bui
         [MethodImpl(MethodImplOptions.NoInlining)]
         public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager)
         {
+            Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");
             return builder.AddZipkinExporter(pluginManager.ConfigureTracesOptions);
         }
 
@@ -413,6 +414,7 @@ public static TracerProviderBuilder AddOtlpGrpcExporter(TracerProviderBuilder bu
         [MethodImpl(MethodImplOptions.NoInlining)]
         public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager, BatchProcessorConfig batch, ZipkinExporterConfig zipkin)
         {
+            Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");
             return builder.AddZipkinExporter(options =>
             {
                 // Copy Auto settings to SDK settings
@@ -454,6 +456,7 @@ public static TracerProviderBuilder AddOtlpGrpcExporter(TracerProviderBuilder bu
         [MethodImpl(MethodImplOptions.NoInlining)]
         public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager, ZipkinExporterConfig zipkin)
         {
+            Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");
             return builder.AddZipkinExporter(options =>
             {
                 // Copy Auto settings to SDK settings

Original file line number	Diff line number	Diff line change
`@@ -368,6 +368,7 @@ public static TracerProviderBuilder AddConsoleExporter(TracerProviderBuilder bui`
`368`	`368`	`[MethodImpl(MethodImplOptions.NoInlining)]`
`369`	`369`	`public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager)`
`370`	`370`	`{`
	`371`	`+ Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");`
`371`	`372`	`return builder.AddZipkinExporter(pluginManager.ConfigureTracesOptions);`
`372`	`373`	`}`
`373`	`374`
`@@ -413,6 +414,7 @@ public static TracerProviderBuilder AddOtlpGrpcExporter(TracerProviderBuilder bu`
`413`	`414`	`[MethodImpl(MethodImplOptions.NoInlining)]`
`414`	`415`	`public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager, BatchProcessorConfig batch, ZipkinExporterConfig zipkin)`
`415`	`416`	`{`
	`417`	`+ Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");`
`416`	`418`	`return builder.AddZipkinExporter(options =>`
`417`	`419`	`{`
`418`	`420`	`// Copy Auto settings to SDK settings`
`@@ -454,6 +456,7 @@ public static TracerProviderBuilder AddOtlpGrpcExporter(TracerProviderBuilder bu`
`454`	`456`	`[MethodImpl(MethodImplOptions.NoInlining)]`
`455`	`457`	`public static TracerProviderBuilder AddZipkinExporter(TracerProviderBuilder builder, PluginManager pluginManager, ZipkinExporterConfig zipkin)`
`456`	`458`	`{`
	`459`	`+ Logger.Warning("Zipkin exporter is deprecated and it is enabled by the configuration. It will be removed in future versions. Consider migrating to OTLP exporter.");`
`457`	`460`	`return builder.AddZipkinExporter(options =>`
`458`	`461`	`{`
`459`	`462`	`// Copy Auto settings to SDK settings`