Files
Larissa Wandzura fa93b3b74c DOCS: Prometheus data sources documentation overhaul (#104427)
* initial updates

* additional updates - index and config dos

* made edits, renamed the index files.

* Close unclosed shortcode

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>

* updated main and config docs

* edits to query editor and templates

* final edits to landing page

* added updates

* made a few additional edits

* edits

* final edits and changes per dev feedback

* reviewed titles and headings; ran prettier

* added ref URIs

* Update docs/sources/datasources/prometheus/template-variables/_index.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update docs/sources/datasources/prometheus/configure/_index.md

Co-authored-by: ismail simsek <ismailsimsek09@gmail.com>

* Update docs/sources/datasources/prometheus/template-variables/_index.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* updates based on feedback

* ran prettier

* updates due to feedback

---------

Signed-off-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Jack Baldry <jack.baldry@grafana.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: ismail simsek <ismailsimsek09@gmail.com>
2025-05-06 14:02:52 +00:00

7.9 KiB

aliases description keywords labels menuTitle title weight refs
../data-sources/prometheus/
../features/datasources/prometheus/
Guide for using Prometheus in Grafana
grafana
prometheus
guide
products
cloud
enterprise
oss
Prometheus Prometheus data source 1300
build-dashboards get-started-prometheus provisioning-data-sources set-up-grafana-monitoring configure-grafana administration-documentation annotate-visualizations exemplars intro-to-prometheus configure-prometheus-data-source annotate-visualizations recorded-queries transformations alerting visualizations variables
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/getting-started/get-started-grafana-prometheus/#get-started-with-grafana-and-prometheus
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/getting-started/get-started-grafana-prometheus/#get-started-with-grafana-and-prometheus
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/provisioning/#data-sources
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/provisioning/#data-sources
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/set-up-grafana-monitoring/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/set-up-grafana-monitoring/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/configure-grafana/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/configure-grafana/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/fundamentals/exemplars/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/fundamentals/exemplars/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/fundamentals/intro-to-prometheus/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/fundamentals/intro-to-prometheus/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/prometheus/configure
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/prometheus/configure
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/recorded-queries/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/recorded-queries/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/query-transform-data/transform-data/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/query-transform-data/transform-data/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/variables/

Prometheus data source

Prometheus is an open source database that uses a telemetry collector agent to scrape and store metrics used for monitoring and alerting.

Grafana provides native support for Prometheus, so you don't need to install a plugin.

The following documentation will help you get started working with Prometheus and Grafana:

Exemplars

In Prometheus, an exemplar is a specific trace that represents a measurement taken within a given time interval. While metrics provide an aggregated view of your system, and traces offer a detailed view of individual requests, exemplars serve as a bridge between the two, linking high-level metrics to specific traces for deeper insights.

Exemplars associate higher-cardinality metadata from a specific event with traditional time series data. Refer to Introduction to exemplars in the Prometheus documentation for detailed information on how they work.

Grafana can show exemplar data alongside a metric both in Explore and in Dashboards.

{{< figure src="/static/img/docs/v74/exemplars.png" class="docs-image--no-shadow" caption="Exemplar window" >}}

You add exemplars when you configure the Prometheus data source.

{{< figure src="/static/img/docs/prometheus/exemplars-10-1.png" max-width="500px" class="docs-image--no-shadow" >}}

Prometheus API

The Prometheus data source also works with other projects that implement the Prometheus querying API.

For more information on how to query other Prometheus-compatible projects from Grafana, refer to the specific product's documentation:

View Grafana metrics with Prometheus

Grafana exposes metrics for Prometheus on the /metrics endpoint and includes a pre-built dashboard to help you start visualizing your metrics immediately.

Complete the following steps to import the pre-built dashboard:

  1. Navigate to the Prometheus configuration page.
  2. Click the Dashboards tab.
  3. Locate the Grafana metrics dashboard in the list and click Import.

For details about these metrics, refer to Internal Grafana metrics.

Amazon Managed Service for Prometheus

Grafana has deprecated the Prometheus data source for Amazon Managed Service for Prometheus. Use the Amazon Managed Service for Prometheus data source instead. The linked documentation outlines the migration steps.

Get the most out of the Prometheus data source

After you install and configure Prometheus you can: