Blog post announcing stable declarative configuration

content/en/blog/2026/stable-declarative-config.md

@@ -0,0 +1,138 @@
+---
+title: Declarative configuration is stable!
+linkTitle: Declarative Config Stabilized
+date: 2026-03-05
+author: >-
+  [Jack Berg](https://github.com/jack-berg)(Grafana Labs)
+# prettier-ignore
+cSpell:ignore: Agrawal Alff Anuraag anuraaga Ashpole Bachert Baeyens brettmc carlosalberto codeboten Danielson dashpole jaydeluca Kielek Kiełkowicz Liudmila lmolkova Lüchinger maryliag Molkova Nevay ocelotl Pellard pellared Shkuro Sloughter Solomchenko trask tsloughter Yahn Yevhenii ysolomchenko yurishkuro zeitlinger
+---
+
+## What happened?
+
+Key portions of the
+[declarative configuration specification](/docs/specs/otel/configuration/#declarative-configuration)
+have been marked stable, including
+
+- The JSON schema for the data model, as defined in
+  [opentelemetry-configuration](https://github.com/open-telemetry/opentelemetry-configuration)
+  which released a stable `1.0.0` release
+- The YAML representation of the data model in files
+  ([spec link](/docs/specs/otel/configuration/data-model/#yaml-file-format))
+- The in-memory representation of the data model
+  ([spec link](/docs/specs/otel/configuration/sdk/#in-memory-configuration-model))
+- The generic representation of a YAML mapping node, `ConfigProperties`
+  ([spec link](/docs/specs/otel/configuration/api/#configprovider))
+- The mechanism for referencing custom plugin components in the data model,
+  `PluginComponentProvider`
+  ([spec link](/docs/specs/otel/configuration/sdk/#plugincomponentprovider))
+- The SDK operations for parsing a YAML file and instantiating SDK components,
+  `Parse` and `Create`
+  ([spec link](/docs/specs/otel/configuration/sdk/#sdk-operations))
+- The standard env var to indicate that declarative config should be used and to
+  point to the path of a config file `OTEL_CONFIG_FILE`
+  ([spec link](/docs/specs/otel/configuration/sdk-environment-variables/#declarative-configuration))
+
+## What's the status of language implementations?
+
+As of now, there are implementations available in five languages:
+
+- C++
+- Go
+- Java
+- JS
+- PHP
+
+Development is underway for .NET and Python.
+
+Additionally, the go implementation is leveraged in the Collector for
+configuring internal telemetry.
+
+Going forward, implementation status can be tracked with the following
+resources:
+
+- [Specification Compliance Matrix](https://github.com/open-telemetry/opentelemetry-specification/blob/9a946352ecdec2565520e9c65d635f6e68d6cdfb/spec-compliance-matrix.md#declarative-configuration),
+  for language status of specification API and SDK features
+- [opentelemetry-configuration Language Support Status](https://github.com/open-telemetry/opentelemetry-configuration/blob/854f201660436d0e66f73785b7b310e4f8d46c6e/language-support-status.md),
+  for fine grain details about the status of specific types and properties
+
+## What does this mean for you?
+
+As language implementations progress, the ability to configure OpenTelemetry
+consistently in various languages will improve. In addition, the new
+configuration model provides a much richer language to specify options that go
+beyond the environment variables supported today. These were two of the goals of
+the configuration working group from the very beginning.
+
+Language implementations stabilize on different timelines than the
+specification, but that should be coming soon. If a language you're using
+doesn't have an implementation yet, or is lacking a feature you'd like to
+implement or see implemented, let us know by opening an issue in
+[opentelemetry-configuration](https://github.com/open-telemetry/opentelemetry-configuration)!
+We'd love to hear from you.
+
+See the docs in your relevant language for details on how to use. If the docs
+don't exist yet, please open an issue in
+[opentelemetry.io](https://github.com/open-telemetry/opentelemetry.io) to
+request them!
+
+Even without a particular language implementation declared stable, it's possible
+the user-facing portions will be stable sooner. Stabilizing the schema is the
+most important thing for a stable user experience.
+
+## What's next?
+
+The work doesn't end here, but the focus does shift:
+
+- Continue to model new concepts in the schema and stabilize existing types as
+  corresponding specification concepts stabilize.
+- Adjust the specification proposal process to be "declarative configuration
+  first". What this means is when a feature is proposed for SDKs, the
+  corresponding declarative config types and properties should be proposed
+  alongside it. The declarative config schema is a key part of the SDK UX, and
+  should be considered early in the design process.
+- Deprecate environment variables which don't interoperate well. Deprecation
+  doesn't mean deletion, but we want to signal that declared configuration is
+  the preferred path and where we're investing.
+  ([tracking issue](https://github.com/open-telemetry/opentelemetry-specification/issues/3967))
+- Even more languages need to implement declarative configuration! With the
+  specification and data model stable, there's no reason not to.
+- The API portion of declarative configuration for configuring instrumentation
+  (i.e. `ConfigProvider`) is out of scope for this initial stabilization. We
+  need more languages to build prototypes.
+- Dynamic configuration story, or how do I change my telemetry at runtime?
+  ([telemetry policy OTEP](https://github.com/open-telemetry/opentelemetry-specification/pull/4738))
+
+## Thanks
+
+A big thank you to all the amazing contributors who made this possible through
+years of collaboration. Special shout out to those who have been around since
+the beginning - not sure we would have started had we known up front it was
+going to take this long and this much effort 😅! Besides those listed below, I
+know I've missed others, including those involved in implementing, reviewing,
+and contributing in other ways.
+
+- Alex Boten [codeboten](https://github.com/codeboten)
+- Anuraag Agrawal [anuraaga](https://github.com/anuraaga)
+- Arthur Silva Sens [ArthurSens](https://github.com/ArthurSens)
+- Brett McBride [brettmc](https://github.com/brettmc)
+- Carlos Alberto Cortez [carlosalberto](https://github.com/carlosalberto)
+- David Ashpole [dashpole](https://github.com/dashpole)
+- Diego Hurtado [ocelotl](https://github.com/ocelotl)
+- Dominic Lüchinger [dol](https://github.com/dol)
+- Gregor Zeitlinger [zeitlinger](https://github.com/zeitlinger)
+- Jamie Danielson [JamieDanielson](https://github.com/JamieDanielson)
+- Jay DeLuca [jaydeluca](https://github.com/jaydeluca)
+- Liudmila Molkova [lmolkova](https://github.com/lmolkova)
+- Marc Alff [Marc Alff](https://github.com/marcalff)
+- Marylia Gutierrez [maryliag](https://github.com/maryliag)
+- Mike Goldsmith [MikeGoldsmith](https://github.com/MikeGoldsmith)
+- Pablo Baeyens [mx-psi](https://github.com/mx-psi)
+- Piotr Kiełkowicz [Kielek](https://github.com/Kielek)
+- Robert Pellard [pellared](https://github.com/pellared)
+- Tobias Bachert [Nevay](https://github.com/Nevay)
+- Trask Stalnaker [trask](https://github.com/trask)
+- Tristan Sloughter [tsloughter](https://github.com/tsloughter)
+- Tyler Yahn [MrAlias](https://github.com/MrAlias)
+- Yevhenii Solomchenko [ysolomchenko](https://github.com/ysolomchenko)
+- Yuri Shkuro [yurishkuro](https://github.com/yurishkuro)

static/refcache.json

@@ -3847,6 +3847,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-19T09:53:40.785062471Z"
   },
+  "https://github.com/Nevay": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:57.498324-06:00"
+  },
   "https://github.com/NimrodAvni78": {
     "StatusCode": 206,
     "LastSeen": "2026-02-19T09:52:53.086612316Z"
@@ -4247,6 +4251,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:51:50.932042617Z"
   },
+  "https://github.com/anuraaga": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:53.18511-06:00"
+  },
   "https://github.com/apache/apisix/blob/master/apisix/plugins/opentelemetry.lua": {
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:57:07.477329223Z"
@@ -4551,6 +4559,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:51:51.406392471Z"
   },
+  "https://github.com/c": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:58.446007-06:00"
+  },
   "https://github.com/c24t": {
     "StatusCode": 206,
     "LastSeen": "2026-02-28T09:47:31.364680314Z"
@@ -5059,6 +5071,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:51:57.411344601Z"
   },
+  "https://github.com/dol": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:55.491306-06:00"
+  },
   "https://github.com/dominicfraser": {
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:52:26.723411421Z"
@@ -6823,6 +6839,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-20T09:52:24.162871549Z"
   },
+  "https://github.com/ocelotl": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-27T09:51:13.126664-06:00"
+  },
   "https://github.com/odeke-em": {
     "StatusCode": 206,
     "LastSeen": "2026-03-02T09:53:37.481547255Z"
@@ -11491,6 +11511,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-28T09:46:42.94477807Z"
   },
+  "https://github.com/open-telemetry/opentelemetry-configuration/blob/854f201660436d0e66f73785b7b310e4f8d46c6e/language-support-status.md": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:46.505655-06:00"
+  },
   "https://github.com/open-telemetry/opentelemetry-configuration/blob/db08177916083273421c1fd10247b63badd6a87a/examples/otel-sdk-migration-config.yaml?from_branch=main": {
     "StatusCode": 206,
     "LastSeen": "2026-02-24T07:00:13.963604-05:00"
@@ -15003,6 +15027,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-24T07:00:16.195229-05:00"
   },
+  "https://github.com/open-telemetry/opentelemetry-specification/blob/9a946352ecdec2565520e9c65d635f6e68d6cdfb/spec-compliance-matrix.md#declarative-configuration": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:44.885014-06:00"
+  },
   "https://github.com/open-telemetry/opentelemetry-specification/blob/af2606810c19c31850738d1fd105b4eca7aa8c98/spec-compliance-matrix.md?from_branch=main": {
     "StatusCode": 206,
     "LastSeen": "2026-02-23T19:29:06.725694-05:00"
@@ -15191,6 +15219,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-20T09:57:14.632625339Z"
   },
+  "https://github.com/open-telemetry/opentelemetry-specification/pull/4738": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-26T16:10:50.893159-06:00"
+  },
   "https://github.com/open-telemetry/opentelemetry-specification/tree/main/oteps/#readme": {
     "StatusCode": 206,
     "LastSeen": "2026-02-25T09:53:56.625250053Z"
@@ -17911,6 +17943,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-19T09:53:48.392335754Z"
   },
+  "https://github.com/ysolomchenko": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-27T08:48:38.597529-06:00"
+  },
   "https://github.com/yuanyuanzhao3": {
     "StatusCode": 206,
     "LastSeen": "2026-02-27T09:52:13.146804122Z"