Rename [Simple|Aggregated]MetricSample to `[Simple|Aggregated]Metri…

…cValue` (#210)

Closes #141

RELEASE_NOTES.md

@@ -30,6 +30,18 @@
   `METRIC_AC_THD_CURRENT` -> `METRIC_AC_TOTAL_HARMONIC_DISTORTION_CURRENT`
   `METRIC_AC_THD_CURRENT_PHASE_[1|2|3]` -> `METRIC_AC_TOTAL_HARMONIC_DISTORTION_CURRENT_PHASE_[1|2|3]`
 
+- Renamed `SimpleMetricSample` to `SimpleMetricValue`, because it does not
+  contain a timestamp, so it does not represent a sample but a value.
+
+- Renamed `AggregatedMetricSample` to `AggregatedMetricValue`, because it does not
+  contain a timestamp, so it does not represent a sample but a value.
+
+- Renamed `MetricSampleVariant` to `MetricValueVariant`.
+
+- Rename `MetricSample.sample` to `MetricSample.value`.
+
+- Rename `SensorMetricSample.sample` to `SensorMetricSample.value`.
+
 ## New Features
 
 - Added a `Frequenz.api.common.v1.types.Decimal` type, compatible with

proto/frequenz/api/common/v1/metrics/metric_sample.proto

@@ -16,7 +16,7 @@ import "google/protobuf/timestamp.proto";
 
 // Represents a single sample of a specific metric, the value of which is either
 // measured or derived at a particular time.
-message SimpleMetricSample {
+message SimpleMetricValue {
   // The value of the metric, which could be either measured or derived.
   float value = 2;
 }
@@ -31,7 +31,7 @@ message SimpleMetricSample {
 // summaries—minimum, maximum, and average values. Individual measurements are
 // are optional, accommodating scenarios where only subsets of this information
 // are available.
-message AggregatedMetricSample {
+message AggregatedMetricValue {
   // The derived average value of the metric.
   float avg_value = 2;
 
@@ -45,20 +45,20 @@ message AggregatedMetricSample {
   repeated float raw_values = 5;
 }
 
-// MetricSampleVariant serves as a union type that can encapsulate either a
-// `SimpleMetricSample` or an `AggregatedMetricSample`.
+// `MetricValueVariant` serves as a union type that can encapsulate either a
+// `SimpleMetricValue` or an `AggregatedMetricValue`.
 //
 // This message is designed to offer flexibility in capturing different
 // granularities of metric samples—either a simple single-point measurement
 // or an aggregated set of measurements for a metric.
 //
-// A `MetricSampleVariant` can hold either a `SimpleMetricSample` or an
-// `AggregatedMetricSample`, but not both simultaneously. Setting one will
+// A `MetricValueVariant` can hold either a `SimpleMetricValue` or an
+// `AggregatedMetricValue`, but not both simultaneously. Setting one will
 // nullify the other.
-message MetricSampleVariant {
-  oneof metric_sample_type {
-    SimpleMetricSample simple_metric = 1;
-    AggregatedMetricSample aggregated_metric = 2;
+message MetricValueVariant {
+  oneof metric_value_variant {
+    SimpleMetricValue simple_metric = 1;
+    AggregatedMetricValue aggregated_metric = 2;
   }
 }
 
@@ -178,7 +178,7 @@ message MetricSample {
   Metric metric = 2;
 
   // The value of the sampled metric.
-  MetricSampleVariant sample = 3;
+  MetricValueVariant value = 3;
 
   // List of bounds that apply to the metric sample.
   //

proto/frequenz/api/common/v1/microgrid/components/components.proto

@@ -214,13 +214,13 @@ message ComponentConnection {
 //        {
 //          sampled_at: "2023-10-01T00:00:00Z",
 //          metric: "DC_VOLTAGE_V",
-//          sample: {},
+//          value: {},
 //          bounds: {},
 //        },
 //        {
 //          sampled_at: "2023-10-01T00:00:00Z",
 //          metric: "DC_VOLTAGE_V",
-//          sample: {},
+//          value: {},
 //          bounds: {},
 //        }
 //      ],

proto/frequenz/api/common/v1/microgrid/sensors/sensors.proto

@@ -120,12 +120,12 @@ enum SensorMetric {
 //        {
 //          sampled_at: "2023-10-01T00:00:00Z",
 //          metric: "METRIC_SENSOR_TEMPERATURE",
-//          sample: metric_sample_type: {simple_metric: {value: 23.5},
+//          value: metric_value_variant: {simple_metric: {value: 23.5},
 //        },
 //        {
 //          sampled_at: "2023-10-01T00:00:00Z",
 //          metric: "METRIC_SENSOR_RELATIVE_HUMIDITY",
-//          sample: metric_sample_type: {simple_metric: {value: 23.5},
+//          value: metric_value_variant: {simple_metric: {value: 23.5},
 //        }
 //      ],
 //      states: [
@@ -209,5 +209,5 @@ message SensorMetricSample {
   frequenz.api.common.v1.metrics.Metric metric = 2;
 
   // The value of the sampled metric.
-  frequenz.api.common.v1.metrics.MetricSampleVariant sample = 3;
+  frequenz.api.common.v1.metrics.MetricValueVariant value = 3;
 }