From 630e9ecb425f41ba9f81eca87f4a87602bfd0baa Mon Sep 17 00:00:00 2001
From: Marc Alff <marc.alff@oracle.com>
Date: Sat, 1 Nov 2025 00:17:28 +0100
Subject: [PATCH] Change JaegerRemote to Experimental

---
 schema-docs.md                        | 136 +++++++++++++-------------
 schema/meta_schema_language_java.yaml |   8 +-
 schema/meta_schema_types.yaml         |  22 ++---
 schema/tracer_provider.json           |   6 +-
 4 files changed, 86 insertions(+), 86 deletions(-)

diff --git a/schema-docs.md b/schema-docs.md
index d34c59cc..2a509ab1 100644
--- a/schema-docs.md
+++ b/schema-docs.md
@@ -26,6 +26,7 @@
   * [ExperimentalHttpInstrumentation](#experimentalhttpinstrumentation)
   * [ExperimentalHttpServerInstrumentation](#experimentalhttpserverinstrumentation)
   * [ExperimentalInstrumentation](#experimentalinstrumentation)
+  * [ExperimentalJaegerRemoteSampler](#experimentaljaegerremotesampler)
   * [ExperimentalLanguageSpecificInstrumentation](#experimentallanguagespecificinstrumentation)
   * [ExperimentalLoggerConfig](#experimentalloggerconfig)
   * [ExperimentalLoggerConfigurator](#experimentalloggerconfigurator)
@@ -54,7 +55,6 @@
   * [IncludeExclude](#includeexclude)
   * [InstrumentType](#instrumenttype)
   * [JaegerPropagator](#jaegerpropagator)
-  * [JaegerRemoteSampler](#jaegerremotesampler)
   * [LastValueAggregation](#lastvalueaggregation)
   * [LoggerProvider](#loggerprovider)
   * [LogRecordExporter](#logrecordexporter)
@@ -1305,6 +1305,63 @@ Usages:
 }</pre>
 </details>
 
+## ExperimentalJaegerRemoteSampler <a id="experimentaljaegerremotesampler"></a>
+
+| Property | Type | Required? | Constraints | Description |
+|---|---|---|---|---|
+| `endpoint` | one of:<br>* `string`<br>* `null`<br> | `false` | No constraints. | TODO |
+| `interval` | one of:<br>* `integer`<br>* `null`<br> | `false` | * `minimum`: `0`<br> | TODO |
+| `initial_sampler` | [`Sampler`](#sampler) | `false` | No constraints. | TODO |
+
+<details>
+<summary>Language support status</summary>
+
+| Property | [java](#java) |
+|---|---|
+| `endpoint` | unknown |
+| `interval` | unknown |
+| `initial_sampler` | unknown |
+</details>
+
+Constraints: 
+
+* `additionalProperties`: `false`
+
+Usages:
+
+* [`Sampler.jaeger_remote/development`](#sampler)
+
+<details>
+<summary>JSON Schema</summary>
+
+[JSON Schema Source File](./schema/tracer_provider.json)
+<pre>{
+  "type": [
+    "object",
+    "null"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "endpoint": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "interval": {
+      "type": [
+        "integer",
+        "null"
+      ],
+      "minimum": 0
+    },
+    "initial_sampler": {
+      "$ref": "#/$defs/Sampler"
+    }
+  }
+}</pre>
+</details>
+
 ## ExperimentalLanguageSpecificInstrumentation <a id="experimentallanguagespecificinstrumentation"></a>
 
 No properties.
@@ -2557,63 +2614,6 @@ Usages:
 }</pre>
 </details>
 
-## JaegerRemoteSampler <a id="jaegerremotesampler"></a>
-
-| Property | Type | Required? | Constraints | Description |
-|---|---|---|---|---|
-| `endpoint` | one of:<br>* `string`<br>* `null`<br> | `false` | No constraints. | TODO |
-| `interval` | one of:<br>* `integer`<br>* `null`<br> | `false` | * `minimum`: `0`<br> | TODO |
-| `initial_sampler` | [`Sampler`](#sampler) | `false` | No constraints. | TODO |
-
-<details>
-<summary>Language support status</summary>
-
-| Property | [java](#java) |
-|---|---|
-| `endpoint` | supported |
-| `interval` | supported |
-| `initial_sampler` | supported |
-</details>
-
-Constraints: 
-
-* `additionalProperties`: `false`
-
-Usages:
-
-* [`Sampler.jaeger_remote`](#sampler)
-
-<details>
-<summary>JSON Schema</summary>
-
-[JSON Schema Source File](./schema/tracer_provider.json)
-<pre>{
-  "type": [
-    "object",
-    "null"
-  ],
-  "additionalProperties": false,
-  "properties": {
-    "endpoint": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "interval": {
-      "type": [
-        "integer",
-        "null"
-      ],
-      "minimum": 0
-    },
-    "initial_sampler": {
-      "$ref": "#/$defs/Sampler"
-    }
-  }
-}</pre>
-</details>
-
 ## LastValueAggregation <a id="lastvalueaggregation"></a>
 
 No properties.
@@ -5076,10 +5076,10 @@ Usages:
 |---|---|---|---|---|
 | `always_off` | [`AlwaysOffSampler`](#alwaysoffsampler) | `false` | No constraints. | Configure sampler to be always_off. |
 | `always_on` | [`AlwaysOnSampler`](#alwaysonsampler) | `false` | No constraints. | Configure sampler to be always_on. |
-| `jaeger_remote` | [`JaegerRemoteSampler`](#jaegerremotesampler) | `false` | No constraints. | TODO |
 | `parent_based` | [`ParentBasedSampler`](#parentbasedsampler) | `false` | No constraints. | Configure sampler to be parent_based. |
 | `trace_id_ratio_based` | [`TraceIdRatioBasedSampler`](#traceidratiobasedsampler) | `false` | No constraints. | Configure sampler to be trace_id_ratio_based. |
 | `probability/development` | [`ExperimentalProbabilitySampler`](#experimentalprobabilitysampler) | `false` | No constraints. | Configure sampler to be probability. |
+| `jaeger_remote/development` | [`ExperimentalJaegerRemoteSampler`](#experimentaljaegerremotesampler) | `false` | No constraints. | TODO |
 
 <details>
 <summary>Language support status</summary>
@@ -5088,10 +5088,10 @@ Usages:
 |---|---|
 | `always_off` | supported |
 | `always_on` | supported |
-| `jaeger_remote` | supported |
 | `parent_based` | supported |
 | `trace_id_ratio_based` | supported |
 | `probability/development` | supported |
+| `jaeger_remote/development` | supported |
 </details>
 
 Constraints: 
@@ -5103,7 +5103,7 @@ Constraints:
 Usages:
 
 * [`TracerProvider.sampler`](#tracerprovider)
-* [`JaegerRemoteSampler.initial_sampler`](#jaegerremotesampler)
+* [`ExperimentalJaegerRemoteSampler.initial_sampler`](#experimentaljaegerremotesampler)
 * [`ParentBasedSampler.root`](#parentbasedsampler)
 * [`ParentBasedSampler.remote_parent_sampled`](#parentbasedsampler)
 * [`ParentBasedSampler.remote_parent_not_sampled`](#parentbasedsampler)
@@ -5131,8 +5131,8 @@ Usages:
     "always_on": {
       "$ref": "#/$defs/AlwaysOnSampler"
     },
-    "jaeger_remote": {
-      "$ref": "#/$defs/JaegerRemoteSampler"
+    "jaeger_remote/development": {
+      "$ref": "#/$defs/ExperimentalJaegerRemoteSampler"
     },
     "parent_based": {
       "$ref": "#/$defs/ParentBasedSampler"
@@ -5720,8 +5720,8 @@ Usages:
         "always_on": {
           "$ref": "#/$defs/AlwaysOnSampler"
         },
-        "jaeger_remote": {
-          "$ref": "#/$defs/JaegerRemoteSampler"
+        "jaeger_remote/development": {
+          "$ref": "#/$defs/ExperimentalJaegerRemoteSampler"
         },
         "parent_based": {
           "$ref": "#/$defs/ParentBasedSampler"
@@ -5748,7 +5748,7 @@ Usages:
       ],
       "additionalProperties": false
     },
-    "JaegerRemoteSampler": {
+    "ExperimentalJaegerRemoteSampler": {
       "type": [
         "object",
         "null"
@@ -6278,6 +6278,7 @@ Latest supported file format: `1.0.0-rc.1`
 | [`ExperimentalHttpInstrumentation`](#experimentalhttpinstrumentation) | supported |  | * `client`: supported<br>* `server`: supported<br> |
 | [`ExperimentalHttpServerInstrumentation`](#experimentalhttpserverinstrumentation) | supported |  | * `request_captured_headers`: supported<br>* `response_captured_headers`: supported<br> |
 | [`ExperimentalInstrumentation`](#experimentalinstrumentation) | supported |  | * `general`: supported<br>* `cpp`: supported<br>* `dotnet`: supported<br>* `erlang`: supported<br>* `go`: supported<br>* `java`: supported<br>* `js`: supported<br>* `php`: supported<br>* `python`: supported<br>* `ruby`: supported<br>* `rust`: supported<br>* `swift`: supported<br> |
+| [`ExperimentalJaegerRemoteSampler`](#experimentaljaegerremotesampler) | unknown |  | * `endpoint`: unknown<br>* `interval`: unknown<br>* `initial_sampler`: unknown<br> |
 | [`ExperimentalLanguageSpecificInstrumentation`](#experimentallanguagespecificinstrumentation) | supported |  |  |
 | [`ExperimentalLoggerConfig`](#experimentalloggerconfig) | supported |  | * `disabled`: supported<br> |
 | [`ExperimentalLoggerConfigurator`](#experimentalloggerconfigurator) | supported |  | * `default_config`: supported<br>* `loggers`: supported<br> |
@@ -6306,7 +6307,6 @@ Latest supported file format: `1.0.0-rc.1`
 | [`IncludeExclude`](#includeexclude) | supported |  | * `included`: supported<br>* `excluded`: supported<br> |
 | [`InstrumentType`](#instrumenttype) | supported |  |  |
 | [`JaegerPropagator`](#jaegerpropagator) | supported |  |  |
-| [`JaegerRemoteSampler`](#jaegerremotesampler) | supported |  | * `endpoint`: supported<br>* `interval`: supported<br>* `initial_sampler`: supported<br> |
 | [`LastValueAggregation`](#lastvalueaggregation) | supported |  |  |
 | [`LoggerProvider`](#loggerprovider) | supported |  | * `processors`: supported<br>* `limits`: supported<br>* `logger_configurator/development`: supported<br> |
 | [`LogRecordExporter`](#logrecordexporter) | supported |  | * `otlp_http`: supported<br>* `otlp_grpc`: supported<br>* `otlp_file/development`: supported<br>* `console`: supported<br> |
@@ -6331,7 +6331,7 @@ Latest supported file format: `1.0.0-rc.1`
 | [`PullMetricReader`](#pullmetricreader) | supported |  | * `exporter`: supported<br>* `producers`: supported<br>* `cardinality_limits`: supported<br> |
 | [`PushMetricExporter`](#pushmetricexporter) | supported |  | * `otlp_http`: supported<br>* `otlp_grpc`: supported<br>* `otlp_file/development`: supported<br>* `console`: supported<br> |
 | [`Resource`](#resource) | supported |  | * `attributes`: supported<br>* `detection/development`: supported<br>* `schema_url`: supported<br>* `attributes_list`: supported<br> |
-| [`Sampler`](#sampler) | supported |  | * `always_off`: supported<br>* `always_on`: supported<br>* `jaeger_remote`: supported<br>* `parent_based`: supported<br>* `trace_id_ratio_based`: supported<br>* `probability/development`: supported<br> |
+| [`Sampler`](#sampler) | supported |  | * `always_off`: supported<br>* `always_on`: supported<br>* `parent_based`: supported<br>* `trace_id_ratio_based`: supported<br>* `probability/development`: supported<br>* `jaeger_remote/development`: supported<br> |
 | [`SimpleLogRecordProcessor`](#simplelogrecordprocessor) | supported |  | * `exporter`: supported<br> |
 | [`SimpleSpanProcessor`](#simplespanprocessor) | supported |  | * `exporter`: supported<br> |
 | [`SpanExporter`](#spanexporter) | supported |  | * `otlp_http`: supported<br>* `otlp_grpc`: supported<br>* `otlp_file/development`: supported<br>* `console`: supported<br>* `zipkin`: supported<br> |
diff --git a/schema/meta_schema_language_java.yaml b/schema/meta_schema_language_java.yaml
index 3d8eeb24..cc50ff53 100644
--- a/schema/meta_schema_language_java.yaml
+++ b/schema/meta_schema_language_java.yaml
@@ -98,6 +98,10 @@ typeSupportStatuses:
     status: supported
     notes: ""
     propertyOverrides: []
+  - type: ExperimentalJaegerRemoteSampler
+    status: unknown
+    notes: ""
+    propertyOverrides: []
   - type: ExperimentalLanguageSpecificInstrumentation
     status: supported
     notes: ""
@@ -216,10 +220,6 @@ typeSupportStatuses:
     status: supported
     notes: ""
     propertyOverrides: []
-  - type: JaegerRemoteSampler
-    status: supported
-    notes: ""
-    propertyOverrides: []
   - type: LastValueAggregation
     status: supported
     notes: ""
diff --git a/schema/meta_schema_types.yaml b/schema/meta_schema_types.yaml
index 0ea83e60..5f5fec47 100644
--- a/schema/meta_schema_types.yaml
+++ b/schema/meta_schema_types.yaml
@@ -513,15 +513,6 @@
 - type: JaegerPropagator
   properties: []
   isSdkExtensionPlugin: false
-- type: JaegerRemoteSampler
-  properties:
-    - property: endpoint
-      description: TODO
-    - property: interval
-      description: TODO
-    - property: initial_sampler
-      description: TODO
-  isSdkExtensionPlugin: false
 - type: LastValueAggregation
   properties: []
   isSdkExtensionPlugin: false
@@ -918,14 +909,14 @@
       description: Configure sampler to be always_off.
     - property: always_on
       description: Configure sampler to be always_on.
-    - property: jaeger_remote
-      description: TODO
     - property: parent_based
       description: Configure sampler to be parent_based.
     - property: trace_id_ratio_based
       description: Configure sampler to be trace_id_ratio_based.
     - property: probability/development
       description: Configure sampler to be probability.
+    - property: jaeger_remote/development
+      description: TODO
   isSdkExtensionPlugin: true
 - type: SimpleLogRecordProcessor
   properties:
@@ -1107,3 +1098,12 @@
         Value must be non-negative. A value of 0 indicates indefinite.
         If omitted or null, 10000 is used.
   isSdkExtensionPlugin: false
+- type: ExperimentalJaegerRemoteSampler
+  properties:
+    - property: endpoint
+      description: TODO
+    - property: interval
+      description: TODO
+    - property: initial_sampler
+      description: TODO
+  isSdkExtensionPlugin: false
diff --git a/schema/tracer_provider.json b/schema/tracer_provider.json
index e7a93bc7..b081caba 100644
--- a/schema/tracer_provider.json
+++ b/schema/tracer_provider.json
@@ -67,8 +67,8 @@
                 "always_on": {
                     "$ref": "#/$defs/AlwaysOnSampler"
                 },
-                "jaeger_remote": {
-                    "$ref": "#/$defs/JaegerRemoteSampler"
+                "jaeger_remote/development": {
+                    "$ref": "#/$defs/ExperimentalJaegerRemoteSampler"
                 },
                 "parent_based": {
                     "$ref": "#/$defs/ParentBasedSampler"
@@ -89,7 +89,7 @@
             "type": ["object", "null"],
             "additionalProperties": false
         },
-        "JaegerRemoteSampler": {
+        "ExperimentalJaegerRemoteSampler": {
             "type": ["object", "null"],
             "additionalProperties": false,
             "properties": {