Add schema for rule based sampler

Makefile

@@ -33,7 +33,7 @@ update-file-format:
 	done
 
 .PHONY: fix-language-implementations
-fix-language-implementations:
+fix-language-implementations: compile-schema
 	npm run-script fix-language-implementations || exit 1; \
 
 .PHONY: generate-markdown

examples/kitchen-sink.yaml

@@ -289,8 +289,45 @@ tracer_provider:
           ratio: 0.01
       local_parent_sampled:
         composite/development:
-          probability:
-            ratio: 0.001
+          # Configure sampler to be rule_based.
+          rule_based:
+            # The rules for the sampler, matched in order. Each rule can have multiple match conditions - the sampler will be applied if all match. 
+            # If no conditions are specified, the rule matches all spans that reach it. If no rules match, the span is not sampled.
+            rules:
+              - attribute_values:
+                  key: http.route
+                  values:
+                    - /healthz
+                    - /livez
+                # Configure sampler when matched.
+                sampler:
+                  # Configure sampler to be always_off if matched.
+                  always_off: # Configure a sampling rule matching http.path attribute patterns.
+              - attribute_patterns:
+                  key: http.path
+                  patterns:
+                    included:
+                      - /internal/*
+                    excluded:
+                      - /internal/special/*
+                # Configure sampler when matched.
+                sampler:
+                  # Configure sampler to be always_on if matched.
+                  always_on: # Configure a sampling rule matching root spans with CLIENT span kind.
+              - is_trace_root: true
+                span_kinds:
+                  - CLIENT
+                sampler:
+                  # Configure sampler to be trace_id_ratio_based if matched.
+                  trace_id_ratio_based:
+                    ratio: 0.05
+              - sampler:
+                  probability:
+                    # Configure ratio.
+                    # If omitted or null, 1.0 is used.
+                    ratio: 0.001
+      # Configure local_parent_not_sampled sampler.
+      # If omitted or null, always_off is used.
       local_parent_not_sampled:
         always_off:
   tracer_configurator/development:

opentelemetry_configuration.json

@@ -520,6 +520,98 @@
         }
       }
     },
+    "ExperimentalComposableRuleBasedSampler": {
+      "type": [
+        "object",
+        "null"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "rules": {
+          "type": [
+            "array",
+            "null"
+          ],
+          "items": {
+            "$ref": "#/$defs/ExperimentalComposableRuleBasedSamplerRule"
+          },
+          "description": "The rules for the sampler, matched in order. Each rule can have multiple match conditions - the sampler will be applied if all match. \nIf no conditions are specified, the rule matches all spans that reach it. If no rules match, the span is not sampled.\n"
+        }
+      }
+    },
+    "ExperimentalComposableRuleBasedSamplerRule": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "attribute_values": {
+          "$ref": "#/$defs/ExperimentalComposableRuleBasedSamplerRuleAttributeValues",
+          "description": "Values to match against a single attribute. Non-string attributes are matched using their string representation:\nfor example, a value of \"404\" would match the http.response.status_code 404. For array attributes, if any\nitem matches, it is considered a match.\n"
+        },
+        "attribute_patterns": {
+          "$ref": "#/$defs/ExperimentalComposableRuleBasedSamplerRuleAttributePatterns",
+          "description": "Patterns to match against a single attribute. Non-string attributes are matched using their string representation:\nfor example, a pattern of \"4*\" would match any http.response.status_code in 400-499. For array attributes, if any\nitem matches, it is considered a match.\n"
+        },
+        "span_kinds": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "$ref": "#/$defs/SpanKind"
+          },
+          "description": "The span kinds to match. If the span's kind matches any of these, it matches."
+        },
+        "is_trace_root": {
+          "type": "boolean",
+          "description": "Whether to match only trace root spans, those without any parent."
+        },
+        "sampler": {
+          "$ref": "#/$defs/ExperimentalComposableSampler",
+          "description": "The sampler to use for matching spans."
+        }
+      },
+      "required": [
+        "sampler"
+      ]
+    },
+    "ExperimentalComposableRuleBasedSamplerRuleAttributePatterns": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "key": {
+          "type": "string",
+          "description": "The attribute key to match against."
+        },
+        "patterns": {
+          "$ref": "#/$defs/IncludeExclude",
+          "description": "The include and exclude patterns to match. If a pattern satisfies any include and doesn't satisfy any exclude, it matches."
+        }
+      },
+      "required": [
+        "key",
+        "patterns"
+      ]
+    },
+    "ExperimentalComposableRuleBasedSamplerRuleAttributeValues": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "key": {
+          "type": "string",
+          "description": "The attribute key to match against."
+        },
+        "values": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "string"
+          },
+          "description": "The attribute values to match against. If the attribute's value matches any of these, it matches."
+        }
+      },
+      "required": [
+        "key",
+        "values"
+      ]
+    },
     "ExperimentalComposableSampler": {
       "type": "object",
       "additionalProperties": {
@@ -546,6 +638,10 @@
         "probability": {
           "$ref": "#/$defs/ExperimentalComposableProbabilitySampler",
           "description": "Configure sampler to be probability."
+        },
+        "rule_based": {
+          "$ref": "#/$defs/ExperimentalComposableRuleBasedSampler",
+          "description": "Configure sampler to be rule_based."
         }
       }
     },
@@ -2031,6 +2127,19 @@
         }
       }
     },
+    "SpanKind": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "enum": [
+        "INTERNAL",
+        "SERVER",
+        "CLIENT",
+        "PRODUCER",
+        "CONSUMER"
+      ]
+    },
     "SpanLimits": {
       "type": "object",
       "additionalProperties": false,