grafana/docs/sources/features
Björn Rabenstein e9bcee30fa Improve documentation for the Prometheus data source (#21415)
Besides minor language corrections, this tries in particular to
provide some clarity about the `step` setting in the Prometheus range
query and the `$__interval` variable:

- First of all: They are both always the same.

- What's really confusing (and arguably really un-helpful) is that the
  _Min time interval_ is multiplied by the resolution
  factor. Therefore, I just state the fact here now but don't add
  anything like "This should be the scrape interval" because it is not
  true (if resolution is `1/10`, a meaningful _Min time interval_ is
  generally a tenth of the scrape interval).

- More helpful is the _Min step_ parameter, because it is not
  multiplied by the resolution factor (which I have now stated
  explicitly). Of course, the _Min time interval_ has to be set to
  something small so that the _Min step_ parameter can kick in.

It would be good if we could also override the _Min time interval_
tool tip because that is where most people will look, and the current,
very Graphite-centric tool tip is very confusing for the Prometheus
query editor, in particular because it doesn't have any hint about the
resolution factor being applied. See #21413.

Signed-off-by: beorn7 <beorn@grafana.com>
2020-01-10 13:51:32 +01:00
..
dashboard Squashed commit of the following: 2016-10-21 11:01:34 +02:00
datasources Improve documentation for the Prometheus data source (#21415) 2020-01-10 13:51:32 +01:00
explore Docs: update content to work with website repo (#20693) 2019-12-05 13:09:57 +01:00
panels Docs: Use https scheme for Grafana playground links (#21360) 2020-01-06 08:25:13 -08:00
_index.md Docs: update content to work with website repo (#20693) 2019-12-05 13:09:57 +01:00
reporting.md Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
shortcuts.md Docs: Update keyboard shortcuts formatting (#19637) 2019-10-07 14:56:00 +02:00