grafana/docs/sources
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
..
administration Docs: Update provisioning.md (#21303) 2019-12-31 07:32:05 -08:00
alerting Docs: Remove comment about upcoming alerting for singlestat and table panels (#21416) 2020-01-09 14:02:08 +01:00
auth Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
contribute Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
enterprise docs: rename premium plugins to enterprise plugins (#21222) 2019-12-20 18:40:25 -05:00
features Improve documentation for the Prometheus data source (#21415) 2020-01-10 13:51:32 +01:00
guides Docs: Use https scheme for Grafana playground links (#21360) 2020-01-06 08:25:13 -08:00
http_api Docs: Update alerting_notification_channels.md (#21245) 2019-12-31 07:30:53 -08:00
installation Docs: explain how to setup the apt repo without helpers (#21194) 2020-01-08 10:38:31 +01:00
permissions Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
plugins Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
project Docs: update content to work with website repo (#20693) 2019-12-05 13:09:57 +01:00
reference Docs: Use https scheme for Grafana playground links (#21360) 2020-01-06 08:25:13 -08:00
tutorials Docs: Use https scheme for Grafana playground links (#21360) 2020-01-06 08:25:13 -08:00
whatsnew wip: enterprise docs 2018-10-18 14:34:25 +02:00
_index.md Docs: Fix aliases/redirects (#21241) 2019-12-30 08:17:03 +01:00
archive.md Docs: update content to work with website repo (#20693) 2019-12-05 13:09:57 +01:00
jsearch.md Added grafana 1.x docs to main repo 2015-03-10 08:56:03 +01:00
menu.yaml Docs: update content to work with website repo (#20693) 2019-12-05 13:09:57 +01:00
search.md Added grafana 1.x docs to main repo 2015-03-10 08:56:03 +01:00
test.md Added grafana 1.x docs to main repo 2015-03-10 08:56:03 +01:00
versions.html_fragment docs(): updated download links 2016-06-23 10:35:47 +02:00