diff --git a/CHANGELOG.md b/CHANGELOG.md index a4c416d0d5b..1925d400d3d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -31,6 +31,8 @@ release. ([#3680](https://github.com/open-telemetry/opentelemetry-specification/pull/3680)) - Add "/" to valid characters for instrument names ([#3684](https://github.com/open-telemetry/opentelemetry-specification/pull/3684)) +- Stabilize the `MetricProducer`. + ([#3685](https://github.com/open-telemetry/opentelemetry-specification/pull/3685)) ### Logs diff --git a/specification/metrics/sdk.md b/specification/metrics/sdk.md index d576fc09181..37f96158e67 100644 --- a/specification/metrics/sdk.md +++ b/specification/metrics/sdk.md @@ -1083,7 +1083,7 @@ SHOULD provide at least the following: * The default output `aggregation` (optional), a function of instrument kind. If not configured, the [default aggregation](#default-aggregation) SHOULD be used. * The default output `temporality` (optional), a function of instrument kind. If not configured, the Cumulative temporality SHOULD be used. * **Status**: [Experimental](../document-status.md) - The default aggregation cardinality limit to use, a function of instrument kind. If not configured, a default value of 2000 SHOULD be used. -* **Status**: [Feature-freeze](../document-status.md) - Zero of more [MetricProducer](#metricproducer)s (optional) to collect metrics from in addition to metrics from the SDK. +* Zero of more [MetricProducer](#metricproducer)s (optional) to collect metrics from in addition to metrics from the SDK. The [MetricReader.Collect](#collect) method allows general-purpose `MetricExporter` instances to explicitly initiate collection, commonly @@ -1472,7 +1472,7 @@ modeled to interact with other components in the SDK: ## MetricProducer -**Status**: [Feature-freeze](../document-status.md) +**Status**: [Stable](../document-status.md) `MetricProducer` defines the interface which bridges to third-party metric sources MUST implement so they can be plugged into an OpenTelemetry @@ -1497,6 +1497,10 @@ libraries to facilitate conversion between delta and cumulative temporalities. +-----------------+ +--------------+ ``` +When new OpenTelemetry integrations are added, the API is the preferred +integration point. The `MetricProducer` is only meant for integrations that +bridge pre-processed data. + ### Interface Definition A `MetricProducer` MUST support the following functions: