From f81bd0c5a0ebae60f0f69722c6f1435c088284f3 Mon Sep 17 00:00:00 2001 From: Liudmila Molkova Date: Wed, 29 Oct 2025 15:16:21 -0700 Subject: [PATCH 01/11] Deprecate zipkin exporter --- spec-compliance-matrix.md | 4 ++-- spec-compliance-matrix/template.yaml | 4 ++-- specification/trace/sdk_exporters/zipkin.md | 9 ++++++++- 3 files changed, 12 insertions(+), 5 deletions(-) diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md index 1a98a55d299..7aaff6a84e6 100644 --- a/spec-compliance-matrix.md +++ b/spec-compliance-matrix.md @@ -334,8 +334,8 @@ Disclaimer: Declarative configuration is currently in Development status - work | **[Zipkin](specification/trace/sdk_exporters/zipkin.md)** | Optional | Go | Java | JS | Python | Ruby | Erlang | PHP | Rust | C++ | .NET | Swift | | Zipkin V1 JSON | X | - | + | | + | - | - | - | - | - | - | - | | Zipkin V1 Thrift | X | - | + | | [-][py1174] | - | - | - | - | - | - | - | -| Zipkin V2 JSON | * | + | + | | + | + | - | + | + | + | + | + | -| Zipkin V2 Protobuf | * | - | + | | + | - | + | - | - | - | - | - | +| Zipkin V2 JSON | X | + | + | | + | + | - | + | + | + | + | + | +| Zipkin V2 Protobuf | X | - | + | | + | - | + | - | - | - | - | - | | Service name mapping | | + | + | + | + | + | + | + | + | + | + | + | | SpanKind mapping | | + | + | + | + | + | + | + | + | + | + | + | | InstrumentationLibrary mapping | | + | + | - | + | + | - | + | + | + | + | + | diff --git a/spec-compliance-matrix/template.yaml b/spec-compliance-matrix/template.yaml index d3eb46a334b..82078059256 100644 --- a/spec-compliance-matrix/template.yaml +++ b/spec-compliance-matrix/template.yaml @@ -375,9 +375,9 @@ sections: - name: Zipkin V1 Thrift optional: true - name: Zipkin V2 JSON - optional_one_of_group_is_required: true + optional: true - name: Zipkin V2 Protobuf - optional_one_of_group_is_required: true + optional: true - name: Service name mapping - name: SpanKind mapping - name: InstrumentationLibrary mapping diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index 9a902619cc5..e3746665279 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -4,7 +4,14 @@ linkTitle: Zipkin # OpenTelemetry to Zipkin Transformation -**Status**: [Stable](../../document-status.md) +**Status**: [Deprecated](../../document-status.md) + +Zipkin exporter support will be removed from OpenTelemetry in Jan 2027. + +_Note: This document remains here for backwards compatibility and +will be removed in a future version. SDKs MAY include Zipkin exporters, +but Zipkin export is not required. +Users may export to Zipkin using [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel)_ This document defines the transformation between OpenTelemetry and Zipkin Spans. The generic transformation [rules specified here](../../common/mapping-to-non-otlp.md) also apply. If a From c2a913bfb91aa3da8ae55dd6d205e19936c71143 Mon Sep 17 00:00:00 2001 From: Liudmila Molkova Date: Mon, 3 Nov 2025 14:38:30 -0800 Subject: [PATCH 02/11] clean up and lint --- specification/trace/sdk_exporters/zipkin.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index e3746665279..77feded444d 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -6,12 +6,14 @@ linkTitle: Zipkin **Status**: [Deprecated](../../document-status.md) -Zipkin exporter support will be removed from OpenTelemetry in Jan 2027. +Zipkin exporter support will be removed from OpenTelemetry specification in Jan 2027. _Note: This document remains here for backwards compatibility and will be removed in a future version. SDKs MAY include Zipkin exporters, -but Zipkin export is not required. -Users may export to Zipkin using [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel)_ +but Zipkin exporter is not required. + +Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/zipkinexporter) collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) +Zipkin server module_ This document defines the transformation between OpenTelemetry and Zipkin Spans. The generic transformation [rules specified here](../../common/mapping-to-non-otlp.md) also apply. If a @@ -76,7 +78,7 @@ not work properly. OpenTelemetry doesn't provide this consistency guarantee. Exporter may chose to override the value for service name based on a local root span to improve Zipkin user experience. -*Note*, the attribute `service.namespace` MUST NOT be used for the Zipkin +_Note_, the attribute `service.namespace` MUST NOT be used for the Zipkin service name and should be sent as a Zipkin tag. ### SpanKind From 097163a0059813b041aeab915876dc100a151752 Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Fri, 7 Nov 2025 15:13:51 -0800 Subject: [PATCH 03/11] deprecate env vars, add changelog --- CHANGELOG.md | 3 + .../sdk-environment-variables.md | 57 ++++++++++--------- specification/trace/sdk_exporters/zipkin.md | 2 - 3 files changed, 33 insertions(+), 29 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1a69002de81..6e5440b7902 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,9 @@ release. ### Traces +- Deprecate Zipkin exporter document and make exporter implementation optional + ([#4715](https://github.com/open-telemetry/opentelemetry-specification/pull/4715/)) + ### Metrics - `AlignedHistogramBucketExemplarReservoir` SHOULD use a time-weighted algorithm. diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index f271bc9ea29..c8e681402fa 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -15,32 +15,33 @@ aliases: -- [Implementation guidelines](#implementation-guidelines) -- [Parsing empty value](#parsing-empty-value) -- [Configuration types](#configuration-types) - * [Boolean](#boolean) - * [Numeric](#numeric) - + [Integer](#integer) - + [Duration](#duration) - + [Timeout](#timeout) - * [String](#string) - + [Enum](#enum) -- [General SDK Configuration](#general-sdk-configuration) -- [Batch Span Processor](#batch-span-processor) -- [Batch LogRecord Processor](#batch-logrecord-processor) -- [Attribute Limits](#attribute-limits) -- [Span Limits](#span-limits) -- [LogRecord Limits](#logrecord-limits) -- [OTLP Exporter](#otlp-exporter) -- [Zipkin Exporter](#zipkin-exporter) -- [Prometheus Exporter](#prometheus-exporter) -- [Exporter Selection](#exporter-selection) - * [In-development Exporter Selection](#in-development-exporter-selection) -- [Metrics SDK Configuration](#metrics-sdk-configuration) - * [Exemplar](#exemplar) - * [Periodic exporting MetricReader](#periodic-exporting-metricreader) -- [Declarative configuration](#declarative-configuration) -- [Language Specific Environment Variables](#language-specific-environment-variables) +- [OpenTelemetry Environment Variable Specification](#opentelemetry-environment-variable-specification) + - [Implementation guidelines](#implementation-guidelines) + - [Parsing empty value](#parsing-empty-value) + - [Configuration types](#configuration-types) + - [Boolean](#boolean) + - [Numeric](#numeric) + - [Integer](#integer) + - [Duration](#duration) + - [Timeout](#timeout) + - [String](#string) + - [Enum](#enum) + - [General SDK Configuration](#general-sdk-configuration) + - [Batch Span Processor](#batch-span-processor) + - [Batch LogRecord Processor](#batch-logrecord-processor) + - [Attribute Limits](#attribute-limits) + - [Span Limits](#span-limits) + - [LogRecord Limits](#logrecord-limits) + - [OTLP Exporter](#otlp-exporter) + - [Zipkin Exporter](#zipkin-exporter) + - [Prometheus Exporter](#prometheus-exporter) + - [Exporter Selection](#exporter-selection) + - [In-development Exporter Selection](#in-development-exporter-selection) + - [Metrics SDK Configuration](#metrics-sdk-configuration) + - [Exemplar](#exemplar) + - [Periodic exporting MetricReader](#periodic-exporting-metricreader) + - [Declarative configuration](#declarative-configuration) + - [Language Specific Environment Variables](#language-specific-environment-variables) @@ -270,6 +271,8 @@ See [OpenTelemetry Protocol Exporter Configuration Options](../protocol/exporter ## Zipkin Exporter +**Status**: [Deprecated](../../document-status.md) + | Name | Description | Default | Type | |-------------------------------|------------------------------------------------------------------------------------|--------------------------------------|-------------| | OTEL_EXPORTER_ZIPKIN_ENDPOINT | Endpoint for Zipkin traces | `http://localhost:9411/api/v2/spans` | [String][] | @@ -308,7 +311,7 @@ The implementation MAY accept a comma-separated list to enable setting multiple Known values for `OTEL_TRACES_EXPORTER` are: - `"otlp"`: [OTLP](https://opentelemetry.io/docs/specs/otlp/) -- `"zipkin"`: [Zipkin](https://zipkin.io/zipkin-api/) (Defaults to [protobuf](https://github.com/openzipkin/zipkin-api/blob/master/zipkin.proto) format) +- `"zipkin"`: [Zipkin](https://zipkin.io/zipkin-api/) (Defaults to [protobuf](https://github.com/openzipkin/zipkin-api/blob/master/zipkin.proto) format). - `"console"`: [Standard Output](../trace/sdk_exporters/stdout.md) - `"logging"`: [Standard Output](../trace/sdk_exporters/stdout.md). It is a deprecated value left for backwards compatibility. It SHOULD NOT be supported by new implementations. diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index 77feded444d..e8cf7e452a3 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -6,8 +6,6 @@ linkTitle: Zipkin **Status**: [Deprecated](../../document-status.md) -Zipkin exporter support will be removed from OpenTelemetry specification in Jan 2027. - _Note: This document remains here for backwards compatibility and will be removed in a future version. SDKs MAY include Zipkin exporters, but Zipkin exporter is not required. From e2b97268946ea35c3f9fd8ee51915baadd77b64a Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Fri, 7 Nov 2025 15:17:35 -0800 Subject: [PATCH 04/11] up --- .../sdk-environment-variables.md | 55 +++++++++---------- 1 file changed, 27 insertions(+), 28 deletions(-) diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index c8e681402fa..1cf10fb0f01 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -15,33 +15,32 @@ aliases: -- [OpenTelemetry Environment Variable Specification](#opentelemetry-environment-variable-specification) - - [Implementation guidelines](#implementation-guidelines) - - [Parsing empty value](#parsing-empty-value) - - [Configuration types](#configuration-types) - - [Boolean](#boolean) - - [Numeric](#numeric) - - [Integer](#integer) - - [Duration](#duration) - - [Timeout](#timeout) - - [String](#string) - - [Enum](#enum) - - [General SDK Configuration](#general-sdk-configuration) - - [Batch Span Processor](#batch-span-processor) - - [Batch LogRecord Processor](#batch-logrecord-processor) - - [Attribute Limits](#attribute-limits) - - [Span Limits](#span-limits) - - [LogRecord Limits](#logrecord-limits) - - [OTLP Exporter](#otlp-exporter) - - [Zipkin Exporter](#zipkin-exporter) - - [Prometheus Exporter](#prometheus-exporter) - - [Exporter Selection](#exporter-selection) - - [In-development Exporter Selection](#in-development-exporter-selection) - - [Metrics SDK Configuration](#metrics-sdk-configuration) - - [Exemplar](#exemplar) - - [Periodic exporting MetricReader](#periodic-exporting-metricreader) - - [Declarative configuration](#declarative-configuration) - - [Language Specific Environment Variables](#language-specific-environment-variables) +- [Implementation guidelines](#implementation-guidelines) +- [Parsing empty value](#parsing-empty-value) +- [Configuration types](#configuration-types) + * [Boolean](#boolean) + * [Numeric](#numeric) + + [Integer](#integer) + + [Duration](#duration) + + [Timeout](#timeout) + * [String](#string) + + [Enum](#enum) +- [General SDK Configuration](#general-sdk-configuration) +- [Batch Span Processor](#batch-span-processor) +- [Batch LogRecord Processor](#batch-logrecord-processor) +- [Attribute Limits](#attribute-limits) +- [Span Limits](#span-limits) +- [LogRecord Limits](#logrecord-limits) +- [OTLP Exporter](#otlp-exporter) +- [Zipkin Exporter](#zipkin-exporter) +- [Prometheus Exporter](#prometheus-exporter) +- [Exporter Selection](#exporter-selection) + * [In-development Exporter Selection](#in-development-exporter-selection) +- [Metrics SDK Configuration](#metrics-sdk-configuration) + * [Exemplar](#exemplar) + * [Periodic exporting MetricReader](#periodic-exporting-metricreader) +- [Declarative configuration](#declarative-configuration) +- [Language Specific Environment Variables](#language-specific-environment-variables) @@ -311,7 +310,7 @@ The implementation MAY accept a comma-separated list to enable setting multiple Known values for `OTEL_TRACES_EXPORTER` are: - `"otlp"`: [OTLP](https://opentelemetry.io/docs/specs/otlp/) -- `"zipkin"`: [Zipkin](https://zipkin.io/zipkin-api/) (Defaults to [protobuf](https://github.com/openzipkin/zipkin-api/blob/master/zipkin.proto) format). +- `"zipkin"`: [Zipkin](https://zipkin.io/zipkin-api/) (Defaults to [protobuf](https://github.com/openzipkin/zipkin-api/blob/master/zipkin.proto) format) - `"console"`: [Standard Output](../trace/sdk_exporters/stdout.md) - `"logging"`: [Standard Output](../trace/sdk_exporters/stdout.md). It is a deprecated value left for backwards compatibility. It SHOULD NOT be supported by new implementations. From 411d15ba3082af113a77d04047eccc286e3885cc Mon Sep 17 00:00:00 2001 From: Liudmila Molkova Date: Tue, 18 Nov 2025 07:12:29 -0800 Subject: [PATCH 05/11] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Robert Pająk --- CHANGELOG.md | 2 +- specification/trace/sdk_exporters/zipkin.md | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index e5ee6eed639..33b6aea0aa8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,7 +11,7 @@ release. ### Traces -- Deprecate Zipkin exporter document and make exporter implementation optional +- Deprecate Zipkin exporter document and make exporter implementation optional. ([#4715](https://github.com/open-telemetry/opentelemetry-specification/pull/4715/)) ### Metrics diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index e8cf7e452a3..058628a195a 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -6,12 +6,12 @@ linkTitle: Zipkin **Status**: [Deprecated](../../document-status.md) -_Note: This document remains here for backwards compatibility and -will be removed in a future version. SDKs MAY include Zipkin exporters, -but Zipkin exporter is not required. - -Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/zipkinexporter) collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) -Zipkin server module_ +> Note: This document remains here for backwards compatibility and +> will be removed in a future version. SDKs MAY include Zipkin exporters, +> but Zipkin exporter is not required. +> +> Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector->contrib/tree/main/exporter/zipkinexporter) collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) +>Zipkin server module. This document defines the transformation between OpenTelemetry and Zipkin Spans. The generic transformation [rules specified here](../../common/mapping-to-non-otlp.md) also apply. If a @@ -76,7 +76,7 @@ not work properly. OpenTelemetry doesn't provide this consistency guarantee. Exporter may chose to override the value for service name based on a local root span to improve Zipkin user experience. -_Note_, the attribute `service.namespace` MUST NOT be used for the Zipkin +Note that the attribute `service.namespace` MUST NOT be used for the Zipkin service name and should be sent as a Zipkin tag. ### SpanKind From 8641a75df0df7e639376ec4258fa8c4d8845ebb6 Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 07:19:35 -0800 Subject: [PATCH 06/11] nits --- specification/trace/sdk_exporters/zipkin.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index 058628a195a..8f5edace397 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -11,7 +11,7 @@ linkTitle: Zipkin > but Zipkin exporter is not required. > > Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector->contrib/tree/main/exporter/zipkinexporter) collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) ->Zipkin server module. +> Zipkin server module. This document defines the transformation between OpenTelemetry and Zipkin Spans. The generic transformation [rules specified here](../../common/mapping-to-non-otlp.md) also apply. If a From c3bfef7af7fbfb66c52a0ca0b1c04367669b0114 Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 07:23:39 -0800 Subject: [PATCH 07/11] nits --- .../sdk-environment-variables.md | 55 ++++++++++--------- 1 file changed, 28 insertions(+), 27 deletions(-) diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index 1cf10fb0f01..05ef4718019 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -15,32 +15,33 @@ aliases: -- [Implementation guidelines](#implementation-guidelines) -- [Parsing empty value](#parsing-empty-value) -- [Configuration types](#configuration-types) - * [Boolean](#boolean) - * [Numeric](#numeric) - + [Integer](#integer) - + [Duration](#duration) - + [Timeout](#timeout) - * [String](#string) - + [Enum](#enum) -- [General SDK Configuration](#general-sdk-configuration) -- [Batch Span Processor](#batch-span-processor) -- [Batch LogRecord Processor](#batch-logrecord-processor) -- [Attribute Limits](#attribute-limits) -- [Span Limits](#span-limits) -- [LogRecord Limits](#logrecord-limits) -- [OTLP Exporter](#otlp-exporter) -- [Zipkin Exporter](#zipkin-exporter) -- [Prometheus Exporter](#prometheus-exporter) -- [Exporter Selection](#exporter-selection) - * [In-development Exporter Selection](#in-development-exporter-selection) -- [Metrics SDK Configuration](#metrics-sdk-configuration) - * [Exemplar](#exemplar) - * [Periodic exporting MetricReader](#periodic-exporting-metricreader) -- [Declarative configuration](#declarative-configuration) -- [Language Specific Environment Variables](#language-specific-environment-variables) +- [OpenTelemetry Environment Variable Specification](#opentelemetry-environment-variable-specification) + - [Implementation guidelines](#implementation-guidelines) + - [Parsing empty value](#parsing-empty-value) + - [Configuration types](#configuration-types) + - [Boolean](#boolean) + - [Numeric](#numeric) + - [Integer](#integer) + - [Duration](#duration) + - [Timeout](#timeout) + - [String](#string) + - [Enum](#enum) + - [General SDK Configuration](#general-sdk-configuration) + - [Batch Span Processor](#batch-span-processor) + - [Batch LogRecord Processor](#batch-logrecord-processor) + - [Attribute Limits](#attribute-limits) + - [Span Limits](#span-limits) + - [LogRecord Limits](#logrecord-limits) + - [OTLP Exporter](#otlp-exporter) + - [Zipkin Exporter](#zipkin-exporter) + - [Prometheus Exporter](#prometheus-exporter) + - [Exporter Selection](#exporter-selection) + - [In-development Exporter Selection](#in-development-exporter-selection) + - [Metrics SDK Configuration](#metrics-sdk-configuration) + - [Exemplar](#exemplar) + - [Periodic exporting MetricReader](#periodic-exporting-metricreader) + - [Declarative configuration](#declarative-configuration) + - [Language Specific Environment Variables](#language-specific-environment-variables) @@ -270,7 +271,7 @@ See [OpenTelemetry Protocol Exporter Configuration Options](../protocol/exporter ## Zipkin Exporter -**Status**: [Deprecated](../../document-status.md) +**Status**: [Deprecated](../document-status.md) | Name | Description | Default | Type | |-------------------------------|------------------------------------------------------------------------------------|--------------------------------------|-------------| From bb1bb60bfd633ae4c4f5c8aa8070dda5d09abcbf Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 07:30:01 -0800 Subject: [PATCH 08/11] undo auto-toc --- .../sdk-environment-variables.md | 53 +++++++++---------- 1 file changed, 26 insertions(+), 27 deletions(-) diff --git a/specification/configuration/sdk-environment-variables.md b/specification/configuration/sdk-environment-variables.md index 05ef4718019..aff527f5913 100644 --- a/specification/configuration/sdk-environment-variables.md +++ b/specification/configuration/sdk-environment-variables.md @@ -15,33 +15,32 @@ aliases: -- [OpenTelemetry Environment Variable Specification](#opentelemetry-environment-variable-specification) - - [Implementation guidelines](#implementation-guidelines) - - [Parsing empty value](#parsing-empty-value) - - [Configuration types](#configuration-types) - - [Boolean](#boolean) - - [Numeric](#numeric) - - [Integer](#integer) - - [Duration](#duration) - - [Timeout](#timeout) - - [String](#string) - - [Enum](#enum) - - [General SDK Configuration](#general-sdk-configuration) - - [Batch Span Processor](#batch-span-processor) - - [Batch LogRecord Processor](#batch-logrecord-processor) - - [Attribute Limits](#attribute-limits) - - [Span Limits](#span-limits) - - [LogRecord Limits](#logrecord-limits) - - [OTLP Exporter](#otlp-exporter) - - [Zipkin Exporter](#zipkin-exporter) - - [Prometheus Exporter](#prometheus-exporter) - - [Exporter Selection](#exporter-selection) - - [In-development Exporter Selection](#in-development-exporter-selection) - - [Metrics SDK Configuration](#metrics-sdk-configuration) - - [Exemplar](#exemplar) - - [Periodic exporting MetricReader](#periodic-exporting-metricreader) - - [Declarative configuration](#declarative-configuration) - - [Language Specific Environment Variables](#language-specific-environment-variables) +- [Implementation guidelines](#implementation-guidelines) +- [Parsing empty value](#parsing-empty-value) +- [Configuration types](#configuration-types) + * [Boolean](#boolean) + * [Numeric](#numeric) + + [Integer](#integer) + + [Duration](#duration) + + [Timeout](#timeout) + * [String](#string) + + [Enum](#enum) +- [General SDK Configuration](#general-sdk-configuration) +- [Batch Span Processor](#batch-span-processor) +- [Batch LogRecord Processor](#batch-logrecord-processor) +- [Attribute Limits](#attribute-limits) +- [Span Limits](#span-limits) +- [LogRecord Limits](#logrecord-limits) +- [OTLP Exporter](#otlp-exporter) +- [Zipkin Exporter](#zipkin-exporter) +- [Prometheus Exporter](#prometheus-exporter) +- [Exporter Selection](#exporter-selection) + * [In-development Exporter Selection](#in-development-exporter-selection) +- [Metrics SDK Configuration](#metrics-sdk-configuration) + * [Exemplar](#exemplar) + * [Periodic exporting MetricReader](#periodic-exporting-metricreader) +- [Declarative configuration](#declarative-configuration) +- [Language Specific Environment Variables](#language-specific-environment-variables) From 4e01afd877fda565fe860cc7c9c048919e531c90 Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 07:51:35 -0800 Subject: [PATCH 09/11] nits --- spec-compliance-matrix.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md index f0a4cb25516..5c7431693bd 100644 --- a/spec-compliance-matrix.md +++ b/spec-compliance-matrix.md @@ -9,7 +9,7 @@ status of the feature is not known. For the `Optional` column, `X` means the feature is optional, blank means the feature is required, and columns marked with `*` mean that for each type of -exporter (OTLP and Zipkin), implementing at least one of the supported +exporter (e.g. OTLP), implementing at least one of the supported formats is required. Implementing more than one format is optional. ## Traces From 384197ce5bcbac76e804a14a6555b6d5e5e6219a Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 08:20:30 -0800 Subject: [PATCH 10/11] up --- specification/trace/sdk_exporters/zipkin.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index 8f5edace397..1f5e867007d 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -10,7 +10,8 @@ linkTitle: Zipkin > will be removed in a future version. SDKs MAY include Zipkin exporters, > but Zipkin exporter is not required. > -> Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector->contrib/tree/main/exporter/zipkinexporter) collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) +> Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/zipkinexporter) +> collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) > Zipkin server module. This document defines the transformation between OpenTelemetry and Zipkin Spans. From d94f465b8f8e1f771b1c86c98e82de025e38156e Mon Sep 17 00:00:00 2001 From: liudmila molkova Date: Tue, 18 Nov 2025 17:11:27 -0800 Subject: [PATCH 11/11] add deadline and details on artifact deprecation --- specification/trace/sdk_exporters/zipkin.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/specification/trace/sdk_exporters/zipkin.md b/specification/trace/sdk_exporters/zipkin.md index 1f5e867007d..32b39d5da0b 100644 --- a/specification/trace/sdk_exporters/zipkin.md +++ b/specification/trace/sdk_exporters/zipkin.md @@ -6,11 +6,16 @@ linkTitle: Zipkin **Status**: [Deprecated](../../document-status.md) +Zipkin exporter support will be removed from OpenTelemetry specification in December +2026. + > Note: This document remains here for backwards compatibility and -> will be removed in a future version. SDKs MAY include Zipkin exporters, -> but Zipkin exporter is not required. +> will be removed in a future version. Existing stable Zipkin exporters MUST +> continue to be supported for at least one year after the artifact is deprecated, +> following the [SDK stability guarantees](/specification/versioning-and-stability.md#sdk-support). +> Implementing a Zipkin exporter is not required for new SDKs. > -> Users may export to Zipkin using [zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/zipkinexporter) +> Users may use [Zipkin exporter](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/zipkinexporter) > collector component or [zipkin-otel](https://github.com/openzipkin-contrib/zipkin-otel) > Zipkin server module.