4.1 KiB
title | seotitle | weight | description | menu | related | influxdb/v2.0/tags | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Scrape Prometheus metrics | Scape Prometheus metrics into InfluxDB | 205 | Use Telegraf, InfluxDB scrapers, or the `prometheus.scrape` Flux function to scrape Prometheus-formatted metrics from an HTTP-accessible endpoint and store them in InfluxDB. |
|
|
|
Use [Telegraf](/{{< latest "telegraf" >}}/){{% oss-only %}}, InfluxDB scrapers,{{% /oss-only %}}
or the [prometheus.scrape
Flux function](/{{< latest "flux" >}}/stdlib/experimental/prometheus/scrape/)
to scrape Prometheus-formatted metrics from an HTTP-accessible endpoint and store them in InfluxDB.
{{% oss-only %}}
{{% /oss-only %}} {{% cloud-only %}}
{{% /cloud-only %}}
Use Telegraf
To use Telegraf to scrape Prometheus-formatted metrics from an HTTP-accessible endpoint and write them to InfluxDB{{% cloud-only %}} Cloud{{% /cloud-only %}}, follow these steps:
- Add the [Prometheus input plugin](/{{< latest "telegraf" >}}/plugins/#input-prometheus) to your Telegraf configuration file.
- Set the
urls
to scrape metrics from. - Set the
metric_version
configuration option to specify which metric parsing version to use (version2
is recommended).
- Set the
- Add the [InfluxDB v2 output plugin](/{{< latest "telegraf" >}}/plugins/#output-influxdb_v2) to your Telegraf configuration file and configure it to to write to InfluxDB{{% cloud-only %}} Cloud{{% /cloud-only %}}.
Example telegraf.conf
# ...
## Collect Prometheus formatted metrics
[[inputs.prometheus]]
urls = ["http://example.com/metrics"]
metric_version = 2
## Write Prometheus formatted metrics to InfluxDB
[[outputs.influxdb_v2]]
urls = ["http://localhost:8086"]
token = "$INFLUX_TOKEN"
organization = "example-org"
bucket = "example-bucket"
# ...
{{% oss-only %}}
Use an InfluxDB scraper
InfluxDB scrapers automatically scrape Prometheus-formatted metrics from an HTTP-accessible endpoint at a regular interval. For information about setting up an InfluxDB scraper, see Scrape data using InfluxDB scrapers.
{{% /oss-only %}}
Use prometheus.scrape()
To use the [prometheus.scrape()
Flux function](/{{< latest "flux" >}}/stdlib/experimental/prometheus/scrape/)
to scrape Prometheus-formatted metrics from an HTTP-accessible endpoint and write
them to InfluxDB{{% cloud-only %}} Cloud{{% /cloud-only %}}, do the following in your Flux script:
- Import the [
experimental/prometheus
package](/{{< latest "flux" >}}/stdlib/experimental/prometheus/). - Use
prometheus.scrape()
and provide the URL to scrape metrics from. - Use [
to()
](/{{< latest "flux" >}}/stdlib/influxdata/influxdb/to/) and specify the InfluxDB{{% cloud-only %}} Cloud{{% /cloud-only %}} bucket to write the scraped metrics to.
Example Flux script
import "experimental/prometheus"
prometheus.scrape(url: "http://example.com/metrics")
|> to(bucket: "example-bucket")
- (Optional) To scrape Prometheus metrics at regular intervals using Flux, add your Flux scraping script as an [InfluxDB task](/{{< latest "influxdb" >}}/process-data/).
For information about scraping Prometheus-formatted metrics with prometheus.scrape()
,
see [Scrape Prometheus metrics with Flux](/{{< latest "flux" >}}/prometheus/scrape-prometheus/).