Add support for OTEL_SEMCONV_STABILITY_OPT_IN (#492)

examples/otel-sdk-migration-config.yaml

@@ -122,3 +122,6 @@ logger_provider:
   limits:
     attribute_value_length_limit: ${OTEL_LOGRECORD_ATTRIBUTE_VALUE_LENGTH_LIMIT}
     attribute_count_limit: ${OTEL_LOGRECORD_ATTRIBUTE_COUNT_LIMIT:-128}
+instrumentation/development:
+  general:
+    stability_opt_in_list: ${OTEL_SEMCONV_STABILITY_OPT_IN}

opentelemetry_configuration.json

@@ -466,6 +466,16 @@
         "trace_based"
       ]
     },
+    "ExperimentalCodeInstrumentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure code semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSee code semantic conventions: https://opentelemetry.io/docs/specs/semconv/registry/attributes/code/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        }
+      }
+    },
     "ExperimentalComposableAlwaysOffSampler": {
       "type": [
         "object",
@@ -659,13 +669,60 @@
       ],
       "additionalProperties": false
     },
+    "ExperimentalDbInstrumentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure database semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSee database migration: https://opentelemetry.io/docs/specs/semconv/database/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        }
+      }
+    },
+    "ExperimentalGenAiInstrumentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure GenAI semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSet .experimental to true to enable latest experimental mode.\n\nSee GenAI semantic conventions: https://opentelemetry.io/docs/specs/semconv/gen-ai/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        }
+      }
+    },
     "ExperimentalGeneralInstrumentation": {
       "type": "object",
       "additionalProperties": false,
       "properties": {
         "http": {
           "$ref": "#/$defs/ExperimentalHttpInstrumentation",
           "description": "Configure instrumentations following the http semantic conventions.\nSee http semantic conventions: https://opentelemetry.io/docs/specs/semconv/http/\nIf omitted, defaults as described in ExperimentalHttpInstrumentation are used.\n"
+        },
+        "code": {
+          "$ref": "#/$defs/ExperimentalCodeInstrumentation",
+          "description": "Configure instrumentations following the code semantic conventions.\nSee code semantic conventions: https://opentelemetry.io/docs/specs/semconv/registry/attributes/code/\nIf omitted, defaults as described in ExperimentalCodeInstrumentation are used.\n"
+        },
+        "db": {
+          "$ref": "#/$defs/ExperimentalDbInstrumentation",
+          "description": "Configure instrumentations following the database semantic conventions.\nSee database semantic conventions: https://opentelemetry.io/docs/specs/semconv/database/\nIf omitted, defaults as described in ExperimentalDbInstrumentation are used.\n"
+        },
+        "gen_ai": {
+          "$ref": "#/$defs/ExperimentalGenAiInstrumentation",
+          "description": "Configure instrumentations following the GenAI semantic conventions.\nSee GenAI semantic conventions: https://opentelemetry.io/docs/specs/semconv/gen-ai/\nIf omitted, defaults as described in ExperimentalGenAiInstrumentation are used.\n"
+        },
+        "messaging": {
+          "$ref": "#/$defs/ExperimentalMessagingInstrumentation",
+          "description": "Configure instrumentations following the messaging semantic conventions.\nSee messaging semantic conventions: https://opentelemetry.io/docs/specs/semconv/messaging/\nIf omitted, defaults as described in ExperimentalMessagingInstrumentation are used.\n"
+        },
+        "rpc": {
+          "$ref": "#/$defs/ExperimentalRpcInstrumentation",
+          "description": "Configure instrumentations following the RPC semantic conventions.\nSee RPC semantic conventions: https://opentelemetry.io/docs/specs/semconv/rpc/\nIf omitted, defaults as described in ExperimentalRpcInstrumentation are used.\n"
+        },
+        "stability_opt_in_list": {
+          "type": [
+            "string",
+            "null"
+          ],
+          "description": "Configure semantic convention stability opt-in as a comma-separated list.\nThis property follows the format and semantics of the OTEL_SEMCONV_STABILITY_OPT_IN environment variable.\nControls the emission of stable vs. experimental semantic conventions for instrumentation.\nThis setting is only intended for migrating from experimental to stable semantic conventions.\n\nKnown values include:\n- http: Emit stable HTTP and networking conventions only\n- http/dup: Emit both old and stable HTTP and networking conventions (for phased migration)\n- database: Emit stable database conventions only\n- database/dup: Emit both old and stable database conventions (for phased migration)\n- rpc: Emit stable RPC conventions only\n- rpc/dup: Emit both experimental and stable RPC conventions (for phased migration)\n- messaging: Emit stable messaging conventions only\n- messaging/dup: Emit both old and stable messaging conventions (for phased migration)\n- code: Emit stable code conventions only\n- code/dup: Emit both old and stable code conventions (for phased migration)\n\nMultiple values can be specified as a comma-separated list (e.g., \"http,database/dup\").\nAdditional signal types may be supported in future versions.\n\nDomain-specific semconv properties (e.g., .instrumentation/development.general.db.semconv) take precedence over this general setting.\n\nSee:\n- HTTP migration: https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/\n- Database migration: https://opentelemetry.io/docs/specs/semconv/database/\n- RPC: https://opentelemetry.io/docs/specs/semconv/rpc/\n- Messaging: https://opentelemetry.io/docs/specs/semconv/messaging/messaging-spans/\nIf omitted or null, no opt-in is configured and instrumentations continue emitting their default semantic convention version.\n"
         }
       }
     },
@@ -710,6 +767,10 @@
       "type": "object",
       "additionalProperties": false,
       "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure HTTP semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSee HTTP migration: https://opentelemetry.io/docs/specs/semconv/non-normative/http-migration/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        },
         "client": {
           "$ref": "#/$defs/ExperimentalHttpClientInstrumentation",
           "description": "Configure instrumentations following the http client semantic conventions.\nIf omitted, defaults as described in ExperimentalHttpClientInstrumentation are used.\n"
@@ -909,6 +970,16 @@
         "config"
       ]
     },
+    "ExperimentalMessagingInstrumentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure messaging semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSee messaging semantic conventions: https://opentelemetry.io/docs/specs/semconv/messaging/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        }
+      }
+    },
     "ExperimentalMeterConfig": {
       "type": [
         "object"
@@ -1134,6 +1205,44 @@
         }
       }
     },
+    "ExperimentalRpcInstrumentation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "semconv": {
+          "$ref": "#/$defs/ExperimentalSemconvConfig",
+          "description": "Configure RPC semantic convention version and migration behavior.\n\nThis property takes precedence over the .instrumentation/development.general.stability_opt_in_list setting.\n\nSee RPC semantic conventions: https://opentelemetry.io/docs/specs/semconv/rpc/\nIf omitted, uses the general stability_opt_in_list setting, or instrumentations continue emitting their default semantic convention version if not set.\n"
+        }
+      }
+    },
+    "ExperimentalSemconvConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "version": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0,
+          "description": "The target semantic convention version for this domain (e.g., 1).\nIf omitted or null, the latest stable version is used, or if no stable version is available and .experimental is true then the latest experimental version is used.\n"
+        },
+        "experimental": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "Use latest experimental semantic conventions (before stable is available or to enable experimental features on top of stable conventions).\nIf omitted or null, false is used.\n"
+        },
+        "dual_emit": {
+          "type": [
+            "boolean",
+            "null"
+          ],
+          "description": "When true, also emit the previous major version alongside the target version.\nFor version=1, the previous version refers to the pre-stable conventions that the instrumentation emitted before the first stable semantic convention version was defined.\nFor version=2 and above, the previous version is the prior stable major version (e.g., version=2, dual_emit=true emits both v2 and v1).\nEnables dual-emit for phased migration between versions.\nIf omitted or null, false is used.\n"
+        }
+      }
+    },
     "ExperimentalServiceResourceDetector": {
       "type": [
         "object",