docs-v2/content/v2.0/reference/flux/stdlib/experimental/prometheus/scrape.md

title	description	menu	weight	related
prometheus.scrape() function	The `prometheus.scrape()` function retrieves Prometheus-formatted metrics from a specified URL.	v2_0_ref name parent prometheus.scrape Prometheus	301	/v2.0/write-data/scrape-data/scrapable-endpoints/

The prometheus.scrape() function retrieves Prometheus-formatted metrics from a specified URL. The function groups metrics (including histogram and summary values) into individual tables.

Function type: Input

{{% warn %}} The prometheus.scrape() function is currently experimental and subject to change at any time. By using this function, you accept the risks of experimental functions. {{% /warn %}}

import "experimental/prometheus"

prometheus.scrape(
  url: "http://localhost:9999/metrics"
)

Parameters

url

The URL to scrape Prometheus-formatted metrics from.

Data type: String

Examples

Scrape Prometheus metrics and write them to InfluxDB

import "experimental/prometheus"

prometheus.scrape(url: "https://example-url.com/metrics")
  |> to(
    org: "example-org",
    bucket: "example-bucket"
  )