Add development maxExportBatchSize parameter to Periodic exporting MetricReader

dashpole · dashpole · commit 04e847be56ab · 2026-02-18T21:54:39.000Z
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -13,6 +13,9 @@ release.
 
 ### Metrics
 
+- Add development `maxExportBatchSize` parameter to Periodic exporting MetricReader.
+  ([#4895](https://github.com/open-telemetry/opentelemetry-specification/pull/4895))
+
 ### Logs
 
 - Stabilize optional `Exception` parameter to Logger Emit.
diff --git a/spec-compliance-matrix.md b/spec-compliance-matrix.md
@@ -187,6 +187,7 @@ formats is required. Implementing more than one format is optional.
 | Metric SDK implements [cardinality limit](./specification/metrics/sdk.md#cardinality-limits) |  | + | + | + | - |  | - |  | - | + | + |  |
 | Metric SDK supports configuring cardinality limit at MeterReader level |  | - | + | + | - |  | - |  | - | - | - |  |
 | Metric SDK supports configuring cardinality limit per metric (using Views) |  | - | + | + | - |  | - |  | - | - | + |  |
+| The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter |  | - | - | - | - | - | - | - | - | - | - | - |
 
 ## Logs
 
diff --git a/spec-compliance-matrix/cpp.yaml b/spec-compliance-matrix/cpp.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '-'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/dotnet.yaml b/spec-compliance-matrix/dotnet.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '+'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/erlang.yaml b/spec-compliance-matrix/erlang.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '-'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/go.yaml b/spec-compliance-matrix/go.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '-'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/java.yaml b/spec-compliance-matrix/java.yaml
@@ -347,6 +347,8 @@ sections:
         status: '+'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '+'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/js.yaml b/spec-compliance-matrix/js.yaml
@@ -347,6 +347,8 @@ sections:
         status: '+'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '+'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/php.yaml b/spec-compliance-matrix/php.yaml
@@ -347,6 +347,8 @@ sections:
         status: '?'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '?'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/python.yaml b/spec-compliance-matrix/python.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '-'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/ruby.yaml b/spec-compliance-matrix/ruby.yaml
@@ -347,6 +347,8 @@ sections:
         status: '?'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '?'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/rust.yaml b/spec-compliance-matrix/rust.yaml
@@ -347,6 +347,8 @@ sections:
         status: '-'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '-'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/swift.yaml b/spec-compliance-matrix/swift.yaml
@@ -347,6 +347,8 @@ sections:
         status: '?'
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
         status: '?'
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter
+        status: '-'
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/spec-compliance-matrix/template.yaml b/spec-compliance-matrix/template.yaml
@@ -227,6 +227,7 @@ sections:
       - name: Metric SDK implements [cardinality limit](./specification/metrics/sdk.md#cardinality-limits)
       - name: Metric SDK supports configuring cardinality limit at MeterReader level
       - name: Metric SDK supports configuring cardinality limit per metric (using Views)
+      - name: The metric SDK's periodic Reader implementation supports the `maxExportBatchSize` parameter.
   - name: Logs
     features:
       - name: LoggerProvider.Get Logger
diff --git a/specification/metrics/sdk.md b/specification/metrics/sdk.md
@@ -1426,6 +1426,18 @@ Configurable parameters:
   consecutive exports. The default value is 60000 (milliseconds).
 * `exportTimeoutMillis` - how long the export can run before it is cancelled.
   The default value is 30000 (milliseconds).
+* **Status**: [Development](../document-status.md) - `maxExportBatchSize` - the
+  maximum number of metric data points in a batch that are provided to a single
+  export.
+
+**Status**: [Development](../document-status.md) - When `maxExportBatchSize` is
+configured, the reader MUST ensure no batch provided to `Export` exceeds the
+`maxExportBatchSize` by splitting the batch of metric data points into smaller
+batches. The reader MUST ensure all metric data points from a single
+`Collect()` are provided to `Export` before metric data points from a
+subsequent `Collect()` so that metric points are sent in-order. The reader MUST
+NOT combine metrics from different `Collect()` calls into the same batch
+provided to `Export`.
 
 The reader MUST synchronize calls to `MetricExporter`'s `Export`
 to make sure that they are not invoked concurrently.
