feat: add experimental view_matching_mode to meter provider

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 * Add `always_record` definition to `Sampler`
   ([#698](https://github.com/open-telemetry/opentelemetry-configuration/pull/698))
+* Add experimental `meter_provider.view_matching_mode/development` property
 * Deprecate `MetricProducer.opencensus` and `OpenCensusMetricProducer`,
   following the deprecation of OpenCensus compatibility in the
   specification

language-support-status.md

@@ -50,7 +50,7 @@ Latest supported file format: `1.0.0`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: supported<br> |
 | `LogRecordLimits` | supported |  | * `attribute_count_limit`: supported<br>* `attribute_value_length_limit`: supported<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: unknown<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | supported |  | * `opencensus`: supported<br> |
 | `MetricReader` | supported |  | * `periodic`: supported<br>* `pull`: supported<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -131,6 +131,7 @@ Latest supported file format: `1.0.0`
 | `ExperimentalTracerConfigurator` | supported |  | * `default_config`: supported<br>* `tracers`: supported<br> |
 | `ExperimentalTracerMatcherAndConfig` | supported |  | * `config`: supported<br>* `name`: supported<br> |
 | `ExperimentalUrlSanitization` | unknown |  | * `sensitive_query_parameters`: unknown<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 
 ## go <a id="go"></a>
@@ -172,7 +173,7 @@ Latest supported file format: `1.0.0`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: not_implemented<br> |
 | `LogRecordLimits` | supported |  | * `attribute_count_limit`: supported<br>* `attribute_value_length_limit`: supported<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: unknown<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | unknown |  | * `opencensus`: unknown<br> |
 | `MetricReader` | unknown |  | * `periodic`: unknown<br>* `pull`: unknown<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -253,6 +254,7 @@ Latest supported file format: `1.0.0`
 | `ExperimentalTracerConfigurator` | not_implemented |  | * `default_config`: not_implemented<br>* `tracers`: not_implemented<br> |
 | `ExperimentalTracerMatcherAndConfig` | unknown |  | * `config`: unknown<br>* `name`: unknown<br> |
 | `ExperimentalUrlSanitization` | unknown |  | * `sensitive_query_parameters`: unknown<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 
 ## java <a id="java"></a>
@@ -294,7 +296,7 @@ Latest supported file format: `1.0.0-rc.3`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: supported<br> |
 | `LogRecordLimits` | supported |  | * `attribute_count_limit`: supported<br>* `attribute_value_length_limit`: supported<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: unknown<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | ignored |  | * `opencensus`: ignored<br> |
 | `MetricReader` | supported |  | * `periodic`: supported<br>* `pull`: supported<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -375,6 +377,7 @@ Latest supported file format: `1.0.0-rc.3`
 | `ExperimentalTracerConfigurator` | supported |  | * `default_config`: supported<br>* `tracers`: supported<br> |
 | `ExperimentalTracerMatcherAndConfig` | supported |  | * `config`: supported<br>* `name`: supported<br> |
 | `ExperimentalUrlSanitization` | unknown |  | * `sensitive_query_parameters`: unknown<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 
 ## js <a id="js"></a>
@@ -416,7 +419,7 @@ Latest supported file format: `1.0.0-rc.3`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: supported<br> |
 | `LogRecordLimits` | supported |  | * `attribute_count_limit`: supported<br>* `attribute_value_length_limit`: supported<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: supported<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | supported |  | * `opencensus`: supported<br> |
 | `MetricReader` | supported |  | * `periodic`: supported<br>* `pull`: supported<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -497,6 +500,7 @@ Latest supported file format: `1.0.0-rc.3`
 | `ExperimentalTracerConfigurator` | not_implemented |  | * `default_config`: not_implemented<br>* `tracers`: not_implemented<br> |
 | `ExperimentalTracerMatcherAndConfig` | not_implemented |  | * `config`: not_implemented<br>* `name`: not_implemented<br> |
 | `ExperimentalUrlSanitization` | not_implemented |  | * `sensitive_query_parameters`: not_implemented<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 
 ## php <a id="php"></a>
@@ -538,7 +542,7 @@ Latest supported file format: `1.0.0-rc.2`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: supported<br> |
 | `LogRecordLimits` | supported |  | * `attribute_count_limit`: supported<br>* `attribute_value_length_limit`: supported<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: unknown<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | not_implemented |  | * `opencensus`: not_implemented<br> |
 | `MetricReader` | supported |  | * `periodic`: supported<br>* `pull`: not_implemented<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -619,6 +623,7 @@ Latest supported file format: `1.0.0-rc.2`
 | `ExperimentalTracerConfigurator` | supported |  | * `default_config`: supported<br>* `tracers`: supported<br> |
 | `ExperimentalTracerMatcherAndConfig` | supported |  | * `config`: supported<br>* `name`: supported<br> |
 | `ExperimentalUrlSanitization` | unknown |  | * `sensitive_query_parameters`: unknown<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 
 ## python <a id="python"></a>
@@ -660,7 +665,7 @@ Latest supported file format: `1.0.0`
 | `LogRecordExporter` | supported |  | * `console`: supported<br>* `otlp_grpc`: supported<br>* `otlp_http`: supported<br>* `otlp_file/development`: supported<br> |
 | `LogRecordLimits` | ignored |  | * `attribute_count_limit`: ignored<br>* `attribute_value_length_limit`: ignored<br> |
 | `LogRecordProcessor` | supported |  | * `batch`: supported<br>* `simple`: supported<br>* `event_to_span_event_bridge/development`: supported<br> |
-| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br> |
+| `MeterProvider` | supported |  | * `exemplar_filter`: supported<br>* `readers`: supported<br>* `views`: supported<br>* `meter_configurator/development`: supported<br>* `view_matching_mode/development`: not_implemented<br> |
 | `MetricProducer` | ignored |  | * `opencensus`: ignored<br> |
 | `MetricReader` | supported |  | * `periodic`: supported<br>* `pull`: supported<br> |
 | `NameStringValuePair` | supported |  | * `name`: supported<br>* `value`: supported<br> |
@@ -741,5 +746,6 @@ Latest supported file format: `1.0.0`
 | `ExperimentalTracerConfigurator` | ignored |  | * `default_config`: ignored<br>* `tracers`: ignored<br> |
 | `ExperimentalTracerMatcherAndConfig` | ignored |  | * `config`: ignored<br>* `name`: ignored<br> |
 | `ExperimentalUrlSanitization` | ignored |  | * `sensitive_query_parameters`: ignored<br> |
+| `ExperimentalViewMatchingMode` | not_implemented |  | * `composable`: not_implemented<br>* `independent`: not_implemented<br> |
 
 

opentelemetry_configuration.json

@@ -1367,6 +1367,16 @@
         }
       }
     },
+    "ExperimentalViewMatchingMode": {
+      "type": [
+        "string",
+        "null"
+      ],
+      "enum": [
+        "independent",
+        "composable"
+      ]
+    },
     "ExplicitBucketHistogramAggregation": {
       "type": [
         "object",
@@ -1668,6 +1678,10 @@
         "meter_configurator/development": {
           "$ref": "#/$defs/ExperimentalMeterConfigurator",
           "description": "Configure meters.\nIf omitted, all meters use default values as described in ExperimentalMeterConfig.\n"
+        },
+        "view_matching_mode/development": {
+          "$ref": "#/$defs/ExperimentalViewMatchingMode",
+          "description": "Controls how multiple matching Views are applied to an Instrument.\nValues include:\n* composable: Combines (merges) matching Views into unified metric streams unless distinct stream names are configured.\n* independent: Creates separate metric streams independently for each matching View.\nIf omitted, independent is used.\n"
         }
       },
       "required": [

schema/meta_schema_language_cpp.yaml

@@ -103,7 +103,9 @@ typeSupportStatuses:
         status: unknown
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: supported
     propertyOverrides: []
@@ -354,3 +356,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: unknown
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meta_schema_language_go.yaml

@@ -111,7 +111,9 @@ typeSupportStatuses:
         status: unknown
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: unknown
     propertyOverrides: []
@@ -376,3 +378,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: unknown
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meta_schema_language_java.yaml

@@ -109,7 +109,9 @@ typeSupportStatuses:
         status: unknown
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: ignored
     propertyOverrides: []
@@ -390,3 +392,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: unknown
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meta_schema_language_js.yaml

@@ -105,7 +105,9 @@ typeSupportStatuses:
     propertyOverrides: []
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: supported
     propertyOverrides: []
@@ -350,3 +352,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: not_implemented
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meta_schema_language_php.yaml

@@ -111,7 +111,9 @@ typeSupportStatuses:
         status: unknown
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: not_implemented
     propertyOverrides: []
@@ -419,3 +421,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: unknown
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meta_schema_language_python.yaml

@@ -101,7 +101,9 @@ typeSupportStatuses:
     propertyOverrides: []
   - type: MeterProvider
     status: supported
-    propertyOverrides: []
+    propertyOverrides:
+      - property: view_matching_mode/development
+        status: not_implemented
   - type: MetricProducer
     status: ignored
     propertyOverrides: []
@@ -344,3 +346,6 @@ typeSupportStatuses:
   - type: ExperimentalUrlSanitization
     status: ignored
     propertyOverrides: []
+  - type: ExperimentalViewMatchingMode
+    status: not_implemented
+    enumOverrides: []

schema/meter_provider.yaml

@@ -26,6 +26,11 @@ properties:
     description: |
       Configure meters.
     defaultBehavior: all meters use default values as described in ExperimentalMeterConfig
+  view_matching_mode/development:
+    $ref: "#/$defs/ExperimentalViewMatchingMode"
+    description: |
+      Controls how multiple matching Views are applied to an Instrument.
+    defaultBehavior: independent is used
 required:
   - readers
 $defs:
@@ -773,3 +778,13 @@ $defs:
           - boolean
         description: Configure if the meter is enabled or not.
         defaultBehavior: true is used
+  ExperimentalViewMatchingMode:
+    type:
+      - string
+      - "null"
+    enum:
+      - independent
+      - composable
+    enumDescriptions:
+      composable: Combines (merges) matching Views into unified metric streams unless distinct stream names are configured.
+      independent: Creates separate metric streams independently for each matching View.

snippets/MeterProvider_composable_views.yaml

@@ -0,0 +1,23 @@
+file_format: "1.1"
+
+meter_provider:
+  # SNIPPET_START
+  # By default, an instrument named "my_instrument" would match both of the registered views
+  # and output two metrics, one with description "first view description", the other with
+  # the original description and a cardinality limit of 1000. By setting the matching mode to
+  # composable, the matching views are merged together and one metric output with description
+  # "first view description" AND cardinality limit of 1000.
+  readers:
+    - periodic:
+        exporter:
+          console:
+  views:
+    - selector:
+        instrument_name: my_instrument
+      stream:
+        description: first view description
+    - selector:
+        instrument_name: my_instrument
+      stream:
+        aggregation_cardinality_limit: 1000
+  view_matching_mode/development: composable

validator/shelltests/invalid_view_matching_mode.test

@@ -0,0 +1,4 @@
+otel_config_validator shelltests/invalid_view_matching_mode.yaml
+>>>2
+jsonschema: '/meter_provider/view_matching_mode~1development' does not validate with https://opentelemetry.io/otelconfig/opentelemetry_configuration.json#/properties/meter_provider/$ref/properties/view_matching_mode~1development/$ref/enum: value must be one of "independent", "composable"
+>>>= 1

validator/shelltests/invalid_view_matching_mode.yaml

@@ -0,0 +1,7 @@
+file_format: "1.1"
+meter_provider:
+  view_matching_mode/development: merge_all
+  readers:
+    - periodic:
+        exporter:
+          console: {}