From 2bc66860eee4d212d51f281f06ec7d834ba766fb Mon Sep 17 00:00:00 2001 From: Jack Berg Date: Thu, 20 Mar 2025 15:52:17 -0500 Subject: [PATCH 1/5] List declarative config supported SDK extension plugin interfaces --- specification/configuration/sdk.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index 25024edecea..3224e806628 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -120,6 +120,31 @@ mechanism. See [create](#create), which details `ComponentProvider` usage in configuration model interpretation. +##### Supported SDK extension plugins + +The [configuration data model](./data-model.md) SHOULD support configuration of +all SDK extension plugin interfaces. SDKs SHOULD +support [registration](#register-componentprovider) of custom implementations of +SDK extension plugin interfaces via the `ComponentProvider mechanism. + +The following table lists the current status of all SDK extension plugin +interfaces in the configuration data model: + +| SDK extension plugin interface | Status | +|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| +| [resource detector](../resource/sdk.md#detecting-resource-information-from-the-environment) | + (in progress [#188](https://github.com/open-telemetry/opentelemetry-configuration/pull/188)) | +| [text map propagator](../context/api-propagators.md#textmap-propagator) | + | +| [span exporter](../trace/sdk.md#span-exporter) | + | +| [span processor](../trace/sdk.md#span-processor) | + | +| [sampler](../trace/sdk.md#sampler) | + | +| [id generator](../trace/sdk.md#id-generators) | - [#70](https://github.com/open-telemetry/opentelemetry-configuration/issues/70) | +| [pull metric reader](../metrics/sdk.md#metricreader) | + | +| [push metric exporter](../metrics/sdk.md#metricexporter) | + | +| [metric producer](../metrics/sdk.md#metricproducer) | + | +| [exemplar reservoir](../metrics/sdk.md#exemplarreservoir) | - [#189](https://github.com/open-telemetry/opentelemetry-configuration/issues/189) | +| [log record exporter](../logs/sdk.md#logrecordexporter) | + | +| [log record processor](../logs/sdk.md#logrecordprocessor) | + | + ##### ComponentsProvider operations The `ComponentsProvider` MUST provide the following functions: From 4f6324e62ca7960657cb5dadbce1a382ab325374 Mon Sep 17 00:00:00 2001 From: Jack Berg Date: Thu, 20 Mar 2025 17:48:07 -0500 Subject: [PATCH 2/5] Fix toc --- specification/configuration/sdk.md | 1 + 1 file changed, 1 insertion(+) diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index 3224e806628..5be0067bb80 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -9,6 +9,7 @@ * [ConfigProvider](#configprovider) * [SDK extension components](#sdk-extension-components) + [ComponentProvider](#componentprovider) + - [Supported SDK extension plugins](#supported-sdk-extension-plugins) - [ComponentsProvider operations](#componentsprovider-operations) * [Create Plugin](#create-plugin) * [Config operations](#config-operations) From 39969fa88bc77631d7e0fdf991ef2b5999df3043 Mon Sep 17 00:00:00 2001 From: Jack Berg Date: Fri, 21 Mar 2025 09:35:32 -0500 Subject: [PATCH 3/5] Fix typo --- specification/configuration/sdk.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index 5be0067bb80..de5abf184f3 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -126,7 +126,7 @@ configuration model interpretation. The [configuration data model](./data-model.md) SHOULD support configuration of all SDK extension plugin interfaces. SDKs SHOULD support [registration](#register-componentprovider) of custom implementations of -SDK extension plugin interfaces via the `ComponentProvider mechanism. +SDK extension plugin interfaces via the `ComponentProvider` mechanism. The following table lists the current status of all SDK extension plugin interfaces in the configuration data model: From e6954273aec63034fbc920bfb2ea28e7de14619a Mon Sep 17 00:00:00 2001 From: Jack Berg Date: Fri, 21 Mar 2025 09:36:21 -0500 Subject: [PATCH 4/5] Add changelog entry --- CHANGELOG.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index f98f54b559b..0e10a548e1b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -27,6 +27,9 @@ release. ### SDK Configuration +- List declarative config supported SDK extension plugin interfaces. + ([#4452](https://github.com/open-telemetry/opentelemetry-specification/pull/4452)) + ### Common ### Supplementary Guidelines From 3354889b8f332e56ac1037c75f45cadeae4a558b Mon Sep 17 00:00:00 2001 From: Jack Berg Date: Tue, 25 Mar 2025 17:58:21 -0500 Subject: [PATCH 5/5] resource detector is supported --- specification/configuration/sdk.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/specification/configuration/sdk.md b/specification/configuration/sdk.md index de5abf184f3..98d0dbf5b4c 100644 --- a/specification/configuration/sdk.md +++ b/specification/configuration/sdk.md @@ -131,20 +131,20 @@ SDK extension plugin interfaces via the `ComponentProvider` mechanism. The following table lists the current status of all SDK extension plugin interfaces in the configuration data model: -| SDK extension plugin interface | Status | -|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------| -| [resource detector](../resource/sdk.md#detecting-resource-information-from-the-environment) | + (in progress [#188](https://github.com/open-telemetry/opentelemetry-configuration/pull/188)) | -| [text map propagator](../context/api-propagators.md#textmap-propagator) | + | -| [span exporter](../trace/sdk.md#span-exporter) | + | -| [span processor](../trace/sdk.md#span-processor) | + | -| [sampler](../trace/sdk.md#sampler) | + | -| [id generator](../trace/sdk.md#id-generators) | - [#70](https://github.com/open-telemetry/opentelemetry-configuration/issues/70) | -| [pull metric reader](../metrics/sdk.md#metricreader) | + | -| [push metric exporter](../metrics/sdk.md#metricexporter) | + | -| [metric producer](../metrics/sdk.md#metricproducer) | + | -| [exemplar reservoir](../metrics/sdk.md#exemplarreservoir) | - [#189](https://github.com/open-telemetry/opentelemetry-configuration/issues/189) | -| [log record exporter](../logs/sdk.md#logrecordexporter) | + | -| [log record processor](../logs/sdk.md#logrecordprocessor) | + | +| SDK extension plugin interface | Status | +|---------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------| +| [resource detector](../resource/sdk.md#detecting-resource-information-from-the-environment) | + | +| [text map propagator](../context/api-propagators.md#textmap-propagator) | + | +| [span exporter](../trace/sdk.md#span-exporter) | + | +| [span processor](../trace/sdk.md#span-processor) | + | +| [sampler](../trace/sdk.md#sampler) | + | +| [id generator](../trace/sdk.md#id-generators) | - [#70](https://github.com/open-telemetry/opentelemetry-configuration/issues/70) | +| [pull metric reader](../metrics/sdk.md#metricreader) | + | +| [push metric exporter](../metrics/sdk.md#metricexporter) | + | +| [metric producer](../metrics/sdk.md#metricproducer) | + | +| [exemplar reservoir](../metrics/sdk.md#exemplarreservoir) | - [#189](https://github.com/open-telemetry/opentelemetry-configuration/issues/189) | +| [log record exporter](../logs/sdk.md#logrecordexporter) | + | +| [log record processor](../logs/sdk.md#logrecordprocessor) | + | ##### ComponentsProvider operations