docs: describe ordering in http query results (#6024)

* docs: describe ordering in http query results * improved text Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com> * better text Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com> * better text Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com> Co-authored-by: Karen Miller <84039272+KMiller-Grafana@users.noreply.github.com>
grafana · May 20, 2022 · 0075085 · 0075085
1 parent 5e465ad
commit 0075085
Showing 1 changed file with 15 additions and 2 deletions.
diff --git a/docs/sources/api/_index.md b/docs/sources/api/_index.md
@@ -155,6 +155,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples
@@ -277,12 +281,17 @@ Where `<matrix value>` is:
     <label key-value pairs>
   },
   "values": [
-    <number: second unix epoch>,
-    <string: value>
+    [
+      <number: second unix epoch>,
+      <string: value>
+    ],
+    ...
   ]
 }
 ```
 
+The items in the `values` array are sorted by timestamp, and the oldest item is first.
+
 And `<stream value>` is:
 
 ```
@@ -300,6 +309,10 @@ And `<stream value>` is:
 }
 ```
 
+The items in the `values` array are sorted by timestamp.
+The most recent item is first when using `direction=backward`.
+The oldest item is first when using `direction=forward`.
+
 See [statistics](#statistics) for information about the statistics returned by Loki.
 
 ### Examples