Update _stats configuration

src/api/server/common.rst

@@ -1405,6 +1405,12 @@ error.
     statistic being easily identified, and the content of each statistic is
     self-describing.
 
+    Statistics are sampled internally on a :ref:`configurable interval
+    <config/stats>`. When monitoring the ``_stats`` endpoint, you need to use
+    a polling frequency of at least twice this to observe accurate results.
+    For example, if the :ref:`interval <config/stats>` is 10 seconds,
+    poll ``_stats`` at least every 5 seconds.
+
     The literal string ``_local`` serves as an alias for the local node name, so
     for all stats URLs, ``{node-name}`` may be replaced with ``_local``, to
     interact with the local node's statistics.
@@ -1504,7 +1510,8 @@ The type of the statistic is included in the ``type`` field, and is one of
 the following:
 
 - ``counter``: Monotonically increasing counter, resets on restart
-- ``histogram``: Binned set of values with meaningful subdivisions
+- ``histogram``: Binned set of values with meaningful subdivisions.
+  Scoped to the current :ref:`collection interval <config/stats>`.
 - ``gauge``: Single numerical value that can go up and down
 
 You can also access individual statistics by quoting the statistics sections

src/api/server/configuration.rst

@@ -108,8 +108,7 @@ interact with the local node's configuration.
                 "max_http_sessions": "10"
             },
             "stats": {
-                "rate": "1000",
-                "samples": "[0, 60, 300, 900]"
+                "interval": "10"
             },
             "uuids": {
                 "algorithm": "utc_random"

src/config/misc.rst

@@ -49,20 +49,12 @@ Statistic Calculation
 
 .. config:section:: stats :: Statistic Calculation
 
-    .. config:option:: rate
+    .. config:option:: interval
 
-        Rate of statistics gathering in milliseconds::
+        Interval between gathering statistics in seconds::
 
             [stats]
-            rate = 1000
-
-    .. config:option:: samples
-
-        Samples are used to track the mean and standard value deviation within
-        specified intervals (in seconds)::
-
-            [stats]
-            samples = [0, 60, 300, 900]
+            interval = 10
 
 .. _config/uuids: