Deprecate MetricProducer.opencensus

CHANGELOG.md

@@ -1,5 +1,10 @@
 ## Unreleased
 
+* Deprecate `MetricProducer.opencensus` and `OpenCensusMetricProducer`,
+  following the deprecation of OpenCensus compatibility in the
+  specification
+  ([#655](https://github.com/open-telemetry/opentelemetry-configuration/pull/655))
+
 ## v1.1.0 - 2026-06-05
 
 ### Schema

opentelemetry_configuration.json

@@ -1672,7 +1672,8 @@
       "properties": {
         "opencensus": {
           "$ref": "#/$defs/OpenCensusMetricProducer",
-          "description": "Configure metric producer to be opencensus.\nIf omitted, ignore.\n"
+          "deprecated": true,
+          "description": "Configure metric producer to be opencensus.\n\n**Deprecated** as of June 2026. This entry will be removed no earlier\nthan June 2027, following the deprecation of OpenCensus compatibility\nrequirements in the specification\n(https://github.com/open-telemetry/opentelemetry-specification/pull/5138).\nExisting OpenCensus shims MAY continue to be supported for backwards\ncompatibility, but new configurations SHOULD NOT use this entry.\nIf omitted, ignore.\n"
         }
       }
     },
@@ -1718,7 +1719,9 @@
         "object",
         "null"
       ],
-      "additionalProperties": false
+      "additionalProperties": false,
+      "deprecated": true,
+      "description": "**Deprecated** as of June 2026. This type will be removed no earlier than\nJune 2027, following the deprecation of OpenCensus compatibility\nrequirements in the specification\n(https://github.com/open-telemetry/opentelemetry-specification/pull/5138).\nSee also the\n[OpenCensus sunset announcement](https://opentelemetry.io/blog/2023/sunsetting-opencensus/).\n"
     },
     "OtlpGrpcExporter": {
       "type": [

schema-docs.md

@@ -1850,7 +1850,7 @@ No snippets.
 
 | Property | Type | Required? | Default and Null Behavior | Constraints | Description |
 |---|---|---|---|---|---|
-| `opencensus` | [`OpenCensusMetricProducer`](#opencensusmetricproducer) | `false` | If omitted, ignore. | No constraints. | Configure metric producer to be opencensus. |
+| `opencensus` | [`OpenCensusMetricProducer`](#opencensusmetricproducer) | `false` | If omitted, ignore. | No constraints. | Configure metric producer to be opencensus.<br><br>**Deprecated** as of June 2026. This entry will be removed no earlier<br>than June 2027, following the deprecation of OpenCensus compatibility<br>requirements in the specification<br>(https://github.com/open-telemetry/opentelemetry-specification/pull/5138).<br>Existing OpenCensus shims MAY continue to be supported for backwards<br>compatibility, but new configurations SHOULD NOT use this entry.<br> |
 
 <details>
 <summary>Language support status</summary>
@@ -1890,7 +1890,8 @@ No snippets.
   "properties": {
     "opencensus": {
       "$ref": "#/$defs/OpenCensusMetricProducer",
-      "description": "Configure metric producer to be opencensus.\nIf omitted, ignore.\n"
+      "deprecated": true,
+      "description": "Configure metric producer to be opencensus.\n\n**Deprecated** as of June 2026. This entry will be removed no earlier\nthan June 2027, following the deprecation of OpenCensus compatibility\nrequirements in the specification\n(https://github.com/open-telemetry/opentelemetry-specification/pull/5138).\nExisting OpenCensus shims MAY continue to be supported for backwards\ncompatibility, but new configurations SHOULD NOT use this entry.\nIf omitted, ignore.\n"
     }
   }
 }</pre>
@@ -2026,7 +2027,9 @@ No snippets.
     "object",
     "null"
   ],
-  "additionalProperties": false
+  "additionalProperties": false,
+  "deprecated": true,
+  "description": "**Deprecated** as of June 2026. This type will be removed no earlier than\nJune 2027, following the deprecation of OpenCensus compatibility\nrequirements in the specification\n(https://github.com/open-telemetry/opentelemetry-specification/pull/5138).\nSee also the\n[OpenCensus sunset announcement](https://opentelemetry.io/blog/2023/sunsetting-opencensus/).\n"
 }</pre>
 </details>
 

schema/meter_provider.yaml

@@ -232,14 +232,31 @@ $defs:
     properties:
       opencensus:
         $ref: "#/$defs/OpenCensusMetricProducer"
-        description: Configure metric producer to be opencensus.
+        deprecated: true
+        description: |
+          Configure metric producer to be opencensus.
+
+          **Deprecated** as of June 2026. This entry will be removed no earlier
+          than June 2027, following the deprecation of OpenCensus compatibility
+          requirements in the specification
+          (https://github.com/open-telemetry/opentelemetry-specification/pull/5138).
+          Existing OpenCensus shims MAY continue to be supported for backwards
+          compatibility, but new configurations SHOULD NOT use this entry.
         defaultBehavior: ignore
     isSdkExtensionPlugin: true
   OpenCensusMetricProducer:
     type:
       - object
       - "null"
     additionalProperties: false
+    deprecated: true
+    description: |
+      **Deprecated** as of June 2026. This type will be removed no earlier than
+      June 2027, following the deprecation of OpenCensus compatibility
+      requirements in the specification
+      (https://github.com/open-telemetry/opentelemetry-specification/pull/5138).
+      See also the
+      [OpenCensus sunset announcement](https://opentelemetry.io/blog/2023/sunsetting-opencensus/).
   ExperimentalPrometheusMetricExporter:
     type:
       - object