Diff

--- a/mod_prometheus/README.markdown	Sun Apr 18 13:42:07 2021 +0200
+++ b/mod_prometheus/README.markdown	Sun Apr 18 14:00:10 2021 +0200
@@ -22,7 +22,7 @@
 requires Prosody’s [internal statistics
 provider](https://prosody.im/doc/statistics#built-in_providers) to be
 enabled.  You may also want to change the default collection interval
-to the one your statistics consumer is using.
+to the one your statistics consumer is using. See below for more information.
 
 ```lua
 statistics = "internal"
@@ -40,6 +40,20 @@
 protocol that is how you can customise its URL.  The default one being
 http://localhost:5280/metrics
 
+Scrape interval vs statistics_interval
+--------------------------------------
+
+The `statistics_interval` should be set to `"manual"` on trunk if and only
+if you have a single Prometheus instance scraping Prosody. This will allow
+the internal statistics gathering to run optimally.
+
+If you have multiple instances scraping Prosody, set `statistics_interval`
+to the scrape interval of Prometheus to avoid errors in rate calculations
+and similar.
+
+Future work will allow the use of `"manual"` with multiple Prometheus
+instances and varying scrape intervals (stay tuned).
+
 Compatibility
 =============