grafana/docs/sources
axlrosen 79747b419b
Doc: Info about $__rate_interval for naive users (#36576)
* Doc: Info about $__rate_interval for naive users

<!--

Thank you for sending a pull request! Here are some tips:

1. If this is your first time, please read our contribution guide at https://github.com/grafana/grafana/blob/main/CONTRIBUTING.md

2. Ensure you include and run the appropriate tests as part of your Pull Request.

3. In a new feature or configuration option, an update to the documentation is necessary. Everything related to the documentation is under the docs folder in the root of the repository.

4. If the Pull Request is a work in progress, make use of GitHub's "Draft PR" feature and mark it as such.

5. If you can not merge your Pull Request due to a merge conflict, Rebase it. This gets it in sync with the main branch.

6. Name your PR as "<FeatureArea>: Describe your change", e.g. Alerting: Prevent race condition. If it's a fix or feature relevant for the changelog describe the user impact in the title. The PR title is used to auto-generate the changelog for issues marked with the "add to changelog" label.

-->

**What this PR does / why we need it**:

For Prometheus newbies (i.e. most of us), it seems like $__rate_interval should be widely used, but the documentation doesn't tell us that. So I added more about why it's good, and an explicit recommendation that it can be a good default value for use if (like most of us) you don't really understand how to choose an interval. (Let me know if that's not actually the case, but that's what I took away from https://github.com/grafana/grafana/issues/21417)

Also fixed a few typos in the existing doc.

**Which issue(s) this PR fixes**:

<!--

- Automatically closes linked issue when the Pull Request is merged.

Usage: "Fixes #<issue number>", or "Fixes (paste link of issue)"

-->

Fixes #

**Special notes for your reviewer**:

* Edits based on suggestions from @beorn7

* Update docs/sources/datasources/prometheus.md

Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com>

Co-authored-by: Ivana Huckova <30407135+ivanahuckova@users.noreply.github.com>
Co-authored-by: achatterjee-grafana <70489351+achatterjee-grafana@users.noreply.github.com>
Co-authored-by: Ivana <ivana.huckova@gmail.com>
2021-07-20 13:25:24 +02:00
..
administration live: mention HA limitations in administration docs (#36752) 2021-07-19 20:05:08 +03:00
alerting Alerting: Fix the table markdown docs (#36901) 2021-07-20 15:37:19 +05:30
auth Docs:Adjust azuread.md for Powershell UUID command (#27323) 2021-07-14 18:55:25 +02:00
basics Docs: Update intro-histograms.md (#35462) 2021-06-10 08:41:38 -07:00
best-practices cleanup shortcodes, asset paths (#34826) 2021-05-28 11:27:40 +02:00
dashboards Updated content to specify method to use to get keyboard shortcuts wh… (#36084) 2021-06-23 18:36:53 +02:00
datasources Doc: Info about $__rate_interval for naive users (#36576) 2021-07-20 13:25:24 +02:00
developers Docs: added documentation for the "prepare time series"-transformation. (#36761) 2021-07-16 10:41:15 +02:00
enterprise Docs: Document which data sources work with caching (#36561) 2021-07-09 02:16:02 -06:00
explore Access control docs: Add a note indicating that Explore can be managed by fine-grained access control (#36703) 2021-07-20 09:03:28 +02:00
getting-started cleanup shortcodes, asset paths (#34826) 2021-05-28 11:27:40 +02:00
http_api Email: Allow configuration of content types for email notifications (#34530) 2021-07-19 13:31:51 +03:00
installation live: add to v8 upgrading section (#36661) 2021-07-20 11:58:24 +03:00
linking fix typo in template (#36082) 2021-06-23 18:58:35 +02:00
live live: better overview in docs (#36506) 2021-07-08 21:03:50 +03:00
manage-users cleanup shortcodes, asset paths (#34826) 2021-05-28 11:27:40 +02:00
panels Docs: fix link to status-history on visualizations index page (#36873) 2021-07-17 00:45:36 -05:00
permissions cleanup shortcodes, asset paths (#34826) 2021-05-28 11:27:40 +02:00
plugins Docs: Update _index.md (#36237) 2021-06-29 09:27:16 -04:00
release-notes ReleaseNotes: Updated changelog and release notes for 7.5.10 (#36802) 2021-07-15 18:04:42 +02:00
shared Update alert doc structure (#34659) 2021-05-25 10:51:28 -04:00
sharing Added note that anonymous access permission is no longer available. (#36142) 2021-06-25 15:46:26 +02:00
troubleshooting cleanup shortcodes, asset paths (#34826) 2021-05-28 11:27:40 +02:00
variables Docs: Fix Azure Monitor refs (#36458) 2021-07-06 10:27:32 -04:00
whatsnew Add AGPL license update to 8.0 changelog, release notes, What's New (#36742) 2021-07-14 07:52:03 -06:00
_index.md Docs: Fix Azure Monitor refs (#36458) 2021-07-06 10:27:32 -04:00
menu.yaml Docs: library panel (#35272) 2021-06-04 20:13:56 +02:00