Add new sampling method to the downsample API

specification/indices/_types/Downsample.ts

@@ -24,4 +24,13 @@ export class DownsampleConfig {
    * The interval at which to aggregate the original time series index.
    */
   fixed_interval: DurationLarge
+  /**
+   * The sampling method used to reduce the documents; it can be either `aggregate` or `last_value`. Defaults to `aggregate`.
+   */
+  sampling_method?: SamplingMethod
+}
+
+enum SamplingMethod {
+  aggregate,
+  last_value
 }

specification/indices/downsample/Request.ts

@@ -23,7 +23,12 @@ import { DownsampleConfig } from '@indices/_types/Downsample'
 
 /**
  * Downsample an index.
- * Aggregate a time series (TSDS) index and store pre-computed statistical summaries (`min`, `max`, `sum`, `value_count` and `avg`) for each metric field grouped by a configured time interval.
+ * Downsamples a time series (TSDS) index and reduces its size by keeping the last value or by pre-aggregating metrics:
+ *
+ * - When running in `aggregate` mode, it pre-calculates and stores statistical summaries (`min`, `max`, `sum`, `value_count` and `avg`)
+ * for each metric field grouped by a configured time interval and their dimensions.
+ * - When running in `last_value` mode, it keeps the last value for each metric in the configured interval and their dimensions.
+ *
  * For example, a TSDS index that contains metrics sampled every 10 seconds can be downsampled to an hourly index.
  * All documents within an hour interval are summarized and stored as a single document in the downsample index.
  *