--- title: "Prometheus data source | Grafana documentation" description: "Guide for using Prometheus in Grafana" --- > For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt). # Prometheus data source Prometheus is an open source monitoring system and time series database that scrapes and stores metrics used for monitoring and alerting. The Prometheus data source is preinstalled in Grafana, so you don’t need to install it manually. Write queries using [PromQL](https://prometheus.io/docs/prometheus/latest/querying/basics/) in the query editor, or use [Metrics Drilldown](/docs/grafana/latest/explore/simplified-exploration/metrics/) to explore metrics without writing queries. The Prometheus data source also works with other projects that implement the [Prometheus querying API](https://prometheus.io/docs/prometheus/latest/querying/api/), including [Grafana Mimir](/docs/mimir/latest/) and [Thanos](https://thanos.io/tip/components/query.md/). ## Supported features Expand table | Feature | Supported | |-----------------|-----------| | Metrics | Yes | | Alerting | Yes | | Annotations | Yes | | Recording rules | Yes | | Exemplars | Yes | ## Get started The following documents help you set up and use the Prometheus data source: - [Configure the Prometheus data source](/docs/grafana/latest/datasources/prometheus/configure/) - [Prometheus query editor](/docs/grafana/latest/datasources/prometheus/query-editor/) - [Template variables](/docs/grafana/latest/datasources/prometheus/template-variables/) - [Annotations](/docs/grafana/latest/datasources/prometheus/annotations/) - [Alerting](/docs/grafana/latest/datasources/prometheus/alerting/) - [Troubleshooting](/docs/grafana/latest/datasources/prometheus/troubleshooting/) ## Additional features After you configure the Prometheus data source, you can: - Use [Metrics Drilldown](/docs/grafana/latest/explore/simplified-exploration/metrics/) to browse and explore your Prometheus metrics without writing PromQL - Use [Explore](/docs/grafana/latest/explore/) to query data without building a dashboard - Add [transformations](/docs/grafana/latest/panels-visualizations/query-transform-data/transform-data/) to manipulate query results - Create [recorded queries](/docs/grafana/latest/administration/recorded-queries/) for pre-aggregated data - Save and reuse PromQL queries across dashboards, Explore, and annotations with [saved queries](/docs/grafana/latest/visualizations/panels-visualizations/query-transform-data/#saved-queries) (available in Grafana Enterprise and Grafana Cloud) - Build a wide variety of [visualizations](/docs/grafana/latest/panels-visualizations/visualizations/) ## Cloud-managed Prometheus services > Note > > In Grafana 13, the core Prometheus data source no longer supports SigV4 (AWS) or Azure AD authentication. These authentication methods have been migrated to dedicated plugins: > > - **Amazon Managed Service for Prometheus:** Use the [Amazon Managed Service for Prometheus data source](/grafana/plugins/grafana-amazonprometheus-datasource/). For migration details, refer to [AWS authentication (deprecated)](/docs/grafana/latest/datasources/prometheus/configure/aws-authentication/). > - **Azure Monitor Managed Service for Prometheus:** Use the [Azure Monitor Managed Service for Prometheus data source](/grafana/plugins/grafana-azureprometheus-datasource/). For migration details, refer to [Azure authentication (deprecated)](/docs/grafana/latest/datasources/prometheus/configure/azure-authentication/). > > Existing data sources using these methods are automatically migrated on startup. ## Plugin updates Grafana still ships with the Prometheus data source out of the box. It’s preinstalled in both Grafana OSS and Grafana Enterprise, so there’s nothing for you to install. Starting with Grafana v13.2, it’s packaged as a standalone plugin rather than built into the Grafana codebase, which means you can update the plugin as needed without waiting for a Grafana release. By default, Grafana checks the plugin catalog and installs the latest version on each server restart. To adjust this behavior: - **Opt out of auto-updates:** Set `preinstall_auto_update` to `false` in your [configuration file](/docs/grafana/latest/setup-grafana/configure-grafana/). - **Update manually:** Update at any time from the **Administration > Plugins** page without restarting Grafana. The standalone plugin requires Grafana 12.3.0 or later. The Prometheus data source bundled with Grafana 13.1 and earlier continues to work as before, and those versions aren’t affected by this change. Users running Grafana 12.3.x through 13.1.x can install the standalone plugin from the plugin catalog if they want the latest features before upgrading to Grafana 13.2. To use the standalone plugin with Grafana 12.3.x through 13.1.x, add the following to your [configuration file](/docs/grafana/latest/setup-grafana/configure-grafana/): ini ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```ini [plugin.prometheus] as_external = true [plugins] ; Install the latest version on startup: preinstall_sync = prometheus ; Or install a specific version: ; preinstall_sync = prometheus@ ``` ## Query with the Grafana CLI You can query this data source from the command line and from AI coding agents using the Grafana CLI, `gcx`. `gcx` gives you and your agent structured, terminal-based access to your Grafana data sources, which is useful for automation and agent-driven investigations. `gcx` supports Grafana Cloud and Grafana OSS or Enterprise v12 and later. Before you query, install and authenticate `gcx`. Refer to the [`gcx` CLI documentation](/docs/grafana/latest/as-code/observability-as-code/grafana-cli/gcx/) for installation, configuration, and the full command reference. For example, to query your Prometheus data source, use the `gcx datasources prometheus` commands: sh ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy ```sh # Run an instant PromQL query using an explicit data source UID gcx datasources prometheus query -d 'up{job="grafana"}' # Run a range query over the last hour gcx datasources prometheus query -d 'rate(http_requests_total[5m])' --since 1h --step 1m # List all labels, or the values for a single label gcx datasources prometheus labels -d gcx datasources prometheus labels -d --label job # Get metadata, including the type and help text, for a metric gcx datasources prometheus metadata -d --metric http_requests_total ``` Replace *``* with the UID of your Prometheus data source. You can omit the `-d` flag when `datasources.prometheus` is configured in your `gcx` context. The same commands work with Prometheus-compatible data sources that `gcx` maps to this resolver, including Amazon Managed Service for Prometheus and other `grafana-*prometheus-datasource` flavors. ## Related resources - [What is Prometheus?](/docs/grafana/latest/fundamentals/intro-to-prometheus/) - [Prometheus data model](https://prometheus.io/docs/concepts/data_model/) - [Getting started with Prometheus](https://prometheus.io/docs/prometheus/latest/getting_started/) - [Grafana community forum](https://community.grafana.com/)