Drop relative-time-ms metric

docs/metrics.rst

@@ -14,7 +14,6 @@ Here is a typical metrics record::
           "race-timestamp": "20160421T042749Z",
           "race-id": "6ebc6e53-ee20-4b0c-99b4-09697987e9f4",
           "@timestamp": 1461213093093,
-          "relative-time-ms": 10507.328,
           "relative-time": 10507.328,
           "track": "geonames",
           "track-params": {
@@ -79,16 +78,6 @@ A UUID that changes on every invocation of Rally. It is intended to group all sa
 
 The timestamp in milliseconds since epoch determined when the sample was taken. For request-related metrics, such as ``latency`` or ``service_time`` this is the timestamp when Rally has issued the request.
 
-relative-time-ms
-~~~~~~~~~~~~~~~~
-
-.. warning::
-
-    This property has been introduced for a transition period between Rally 2.1.0 and Rally 2.3.0. It is deprecated with Rally 2.2.1 and will be removed in Rally 2.3.0. Use ``relative-time`` instead.
-
-
-The relative time in milliseconds since the start of the benchmark. This is useful for comparing time-series graphs over multiple races, e.g. you might want to compare the indexing throughput over time across multiple races. As they should always start at the same (relative) point in time, absolute timestamps are not helpful.
-
 relative-time
 ~~~~~~~~~~~~~
 

docs/migrate.rst

@@ -1,6 +1,19 @@
 Migration Guide
 ===============
 
+Migrating to Rally 2.3.0
+------------------------
+
+``relative-time-ms`` is removed
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. note::
+
+    This removal is only relevant if you have configured an Elasticsearch metrics store for Rally.
+
+The deprecated property ``relative-time-ms`` has been removed in Rally 2.3.0. Use the property ``relative-time`` instead to retrieve the same metric.
+
+
 Migrating to Rally 2.2.1
 ------------------------
 

docs/recipes.rst

@@ -270,7 +270,6 @@ The number of hits from queries can also be investigated if you have configured
 
 	{
 	  "@timestamp" : 1597681313435,
-	  "relative-time-ms" : 130273.374,
 	  "relative-time" : 130273.374,
 	  "race-id" : "452ad9d7-9c21-4828-848e-89974af3230e",
 	  "race-timestamp" : "20200817T160412Z",

esrally/metrics.py

@@ -521,8 +521,6 @@ def _put_metric(self, level, level_key, name, value, unit, task, operation, oper
 
         doc = {
             "@timestamp": time.to_epoch_millis(absolute_time),
-            # deprecated
-            "relative-time-ms": convert.seconds_to_ms(relative_time),
             "relative-time": convert.seconds_to_ms(relative_time),
             "race-id": self._race_id,
             "race-timestamp": self._race_timestamp,
@@ -580,8 +578,6 @@ def put_doc(self, doc, level=None, node_name=None, meta_data=None, absolute_time
 
         doc.update({
             "@timestamp": time.to_epoch_millis(absolute_time),
-            # deprecated
-            "relative-time-ms": convert.seconds_to_ms(relative_time),
             "relative-time": convert.seconds_to_ms(relative_time),
             "race-id": self._race_id,
             "race-timestamp": self._race_timestamp,

esrally/resources/metrics-template.json

@@ -28,9 +28,6 @@
           "type": "date",
           "format": "epoch_millis"
         },
-        "relative-time-ms": {
-          "type": "float"
-        },
         "relative-time": {
           "type": "float"
         },

tests/metrics_test.py

@@ -314,7 +314,6 @@ def test_put_value_without_meta_info(self):
             "@timestamp": StaticClock.NOW * 1000,
             "race-id": EsMetricsTests.RACE_ID,
             "race-timestamp": "20160131T000000Z",
-            "relative-time-ms": 0,
             "relative-time": 0,
             "environment": "unittest",
             "sample-type": "normal",
@@ -344,7 +343,6 @@ def test_put_value_with_explicit_timestamps(self):
             "@timestamp": 0,
             "race-id": EsMetricsTests.RACE_ID,
             "race-timestamp": "20160131T000000Z",
-            "relative-time-ms": 10000,
             "relative-time": 10000,
             "environment": "unittest",
             "sample-type": "normal",
@@ -383,7 +381,6 @@ def test_put_value_with_meta_info(self):
             "@timestamp": StaticClock.NOW * 1000,
             "race-id": EsMetricsTests.RACE_ID,
             "race-timestamp": "20160131T000000Z",
-            "relative-time-ms": 0,
             "relative-time": 0,
             "environment": "unittest",
             "sample-type": "normal",
@@ -422,7 +419,6 @@ def test_put_doc_no_meta_data(self):
             "@timestamp": StaticClock.NOW * 1000,
             "race-id": EsMetricsTests.RACE_ID,
             "race-timestamp": "20160131T000000Z",
-            "relative-time-ms": 0,
             "relative-time": 0,
             "environment": "unittest",
             "track": "test",
@@ -468,7 +464,6 @@ def test_put_doc_with_metadata(self):
             "@timestamp": StaticClock.NOW * 1000,
             "race-id": EsMetricsTests.RACE_ID,
             "race-timestamp": "20160131T000000Z",
-            "relative-time-ms": 0,
             "relative-time": 0,
             "environment": "unittest",
             "track": "test",
@@ -1822,7 +1817,6 @@ def test_add_administrative_task_with_error_rate_in_report(self):
         self.metrics_store.open(InMemoryMetricsStoreTests.RACE_ID, InMemoryMetricsStoreTests.RACE_TIMESTAMP,
                                 "test", "append-fast-with-conflicts", "defaults", create=True)
         self.metrics_store.put_doc(doc={"@timestamp": 1595896761994,
-                                        "relative-time-ms": 283.382,
                                         "relative-time": 283.382,
                                         "race-id": "fb26018b-428d-4528-b36b-cf8c54a303ec",
                                         "race-timestamp": "20200728T003905Z", "environment": "local",