---
title: Prometheus metric parsing formats
description: When scraping Prometheus-formatted metrics and writing them to InfluxDB, metrics are parsed and stored in InfluxDB in different formats.
url: https://docs.influxdata.com/influxdb/v2/reference/prometheus-metrics/
estimated_tokens: 9802
product: InfluxDB OSS v2
version: v2
---

# Prometheus metric parsing formats

This page documents an earlier version of InfluxDB OSS. [InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a copy of the database file doesn’t expose usable tokens. Existing tokens are hashed on first startup and the original strings can’t be recovered afterward — **capture any plaintext tokens you still need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

[Prometheus-formatted metrics](https://prometheus.io/docs/concepts/data_model/) are parsed and written to InfluxDB in one of two formats, depending on the scraping tool used:

-   [Metric version 1](#metric-version-1)
-   [Metric version 2](#metric-version-2)

#### Scraping tools and parsing format

| Scraping tool | InfluxDB Metric version |
| --- | --- |
| Telegraf Prometheus plugin | Determined by metric_version configuration option |
| InfluxDB scraper | 1 |
| Flux prometheus.scrape() | 2 |

## Metric version 1

-   **\_time**: timestamp
-   **\_measurement**: [Prometheus metric name](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) *(`_bucket`, `_sum`, and `_count` are trimmed from histogram and summary metric names)*
-   **\_field**: *depends on the [Prometheus metric type](https://prometheus.io/docs/concepts/metric_types/)*
    -   Counter: `counter`
    -   Gauge: `gauge`
    -   Histogram: *histogram bucket upper limits*, `count`, `sum`
    -   Summary: *summary quantiles*, `count`, `sum`
-   **\_value**: [Prometheus metric value](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)
-   **tags**: A tag for each [Prometheus label](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) *(except for histogram bucket upper limits (`le`) or summary quantiles (`quantile`))*. The label name is the tag key and the label value is the tag value.

### Example Prometheus query results

The following are example Prometheus metrics scraped from the **InfluxDB OSS 2.x `/metrics`** endpoint:

```sh
# HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.
# TYPE go_memstats_alloc_bytes_total counter
go_memstats_alloc_bytes_total 1.42276424e+09
# HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.
# TYPE go_memstats_buck_hash_sys_bytes gauge
go_memstats_buck_hash_sys_bytes 5.259247e+06
# HELP task_executor_run_latency_seconds Records the latency between the time the run was due to run and the time the task started execution, by task type
# TYPE task_executor_run_latency_seconds histogram
task_executor_run_latency_seconds_bucket{task_type="system",le="0.25"} 4413
task_executor_run_latency_seconds_bucket{task_type="system",le="0.5"} 11901
task_executor_run_latency_seconds_bucket{task_type="system",le="1"} 12565
task_executor_run_latency_seconds_bucket{task_type="system",le="2.5"} 12823
task_executor_run_latency_seconds_bucket{task_type="system",le="5"} 12844
task_executor_run_latency_seconds_bucket{task_type="system",le="10"} 12864
task_executor_run_latency_seconds_bucket{task_type="system",le="+Inf"} 74429
task_executor_run_latency_seconds_sum{task_type="system"} 4.256783538679698e+11
task_executor_run_latency_seconds_count{task_type="system"} 74429
# HELP task_executor_run_duration The duration in seconds between a run starting and finishing.
# TYPE task_executor_run_duration summary
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.5"} 5.178160855
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.9"} 5.178160855
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.99"} 5.178160855
task_executor_run_duration_sum{taskID="00xx0Xx0xx00XX0x0",task_type="threshold"} 2121.9758301650004
task_executor_run_duration_count{taskID="00xx0Xx0xx00XX0x0",task_type="threshold"} 570
```

#### Resulting line protocol

```
go_memstats_alloc_bytes_total counter=1.42276424e+09
go_memstats_buck_hash_sys_bytes gauge=5.259247e+06
task_executor_run_latency_seconds,task_type=system 0.25=4413,0.5=11901,1=12565,2.5=12823,5=12844,10=12864,+Inf=74429,sum=4.256783538679698e+11,count=74429
task_executor_run_duration,taskID=00xx0Xx0xx00XX0x0,task_type=threshold 0.5=5.178160855,0.9=5.178160855,0.99=5.178160855,sum=2121.9758301650004,count=570
```

[](#view-version-1-tables-when-queried-from-influxdb)

View version 1 tables when queried from InfluxDB

| _time | _measurement | _field | _value |
| --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | go_memstats_alloc_bytes_total | counter | 1422764240.0 |

| _time | _measurement | _field | _value |
| --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | go_memstats_buck_hash_sys_bytes | gauge | 5259247.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | 0.25 | 4413.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | 0.5 | 11901.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | 1 | 12565.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | 2.5 | 12823.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | 5 | 12844.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | +Inf | 74429.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | sum | 425678353867.9698 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_latency_seconds | system | count | 74429.0 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_duration | threshold | 0.5 | 5.178160855 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_duration | threshold | 0.9 | 5.178160855 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_duration | threshold | 0.99 | 5.178160855 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_duration | threshold | sum | 2121.9758301650004 |

| _time | _measurement | task_type | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | task_executor_run_duration | threshold | count | 570.0 |

## Metrics version 2

-   **\_time**: timestamp
-   **\_measurement**: `prometheus`
-   **\_field**: [Prometheus metric name](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels) *(`_bucket` is trimmed from histogram metric names)*
-   **\_value**: [Prometheus metric value](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels)
-   **url**: URL metrics were scraped from
-   **tags**: A tag for each [Prometheus label](https://prometheus.io/docs/concepts/data_model/#metric-names-and-labels). The label name is the tag key and the label value is the tag value.

### Example Prometheus query results

The following are example Prometheus metrics scraped from the **InfluxDB OSS 2.x `/metrics`** endpoint:

```sh
# HELP go_memstats_alloc_bytes_total Total number of bytes allocated, even if freed.
# TYPE go_memstats_alloc_bytes_total counter
go_memstats_alloc_bytes_total 1.42276424e+09
# HELP go_memstats_buck_hash_sys_bytes Number of bytes used by the profiling bucket hash table.
# TYPE go_memstats_buck_hash_sys_bytes gauge
go_memstats_buck_hash_sys_bytes 5.259247e+06
# HELP task_executor_run_latency_seconds Records the latency between the time the run was due to run and the time the task started execution, by task type
# TYPE task_executor_run_latency_seconds histogram
task_executor_run_latency_seconds_bucket{task_type="system",le="0.25"} 4413
task_executor_run_latency_seconds_bucket{task_type="system",le="0.5"} 11901
task_executor_run_latency_seconds_bucket{task_type="system",le="1"} 12565
task_executor_run_latency_seconds_bucket{task_type="system",le="2.5"} 12823
task_executor_run_latency_seconds_bucket{task_type="system",le="5"} 12844
task_executor_run_latency_seconds_bucket{task_type="system",le="10"} 12864
task_executor_run_latency_seconds_bucket{task_type="system",le="+Inf"} 74429
task_executor_run_latency_seconds_sum{task_type="system"} 4.256783538679698e+11
task_executor_run_latency_seconds_count{task_type="system"} 74429
# HELP task_executor_run_duration The duration in seconds between a run starting and finishing.
# TYPE task_executor_run_duration summary
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.5"} 5.178160855
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.9"} 5.178160855
task_executor_run_duration{taskID="00xx0Xx0xx00XX0x0",task_type="threshold",quantile="0.99"} 5.178160855
task_executor_run_duration_sum{taskID="00xx0Xx0xx00XX0x0",task_type="threshold"} 2121.9758301650004
task_executor_run_duration_count{taskID="00xx0Xx0xx00XX0x0",task_type="threshold"} 570
```

#### Resulting line protocol

```
prometheus,url=http://localhost:8086/metrics go_memstats_alloc_bytes_total=1.42276424e+09
prometheus,url=http://localhost:8086/metrics go_memstats_buck_hash_sys_bytes=5.259247e+06
prometheus,url=http://localhost:8086/metrics,task_type=system,le=0.25 task_executor_run_latency_seconds=4413
prometheus,url=http://localhost:8086/metrics,task_type=system,le=0.5 task_executor_run_latency_seconds=11901
prometheus,url=http://localhost:8086/metrics,task_type=system,le=1 task_executor_run_latency_seconds=12565
prometheus,url=http://localhost:8086/metrics,task_type=system,le=2.5 task_executor_run_latency_seconds=12823
prometheus,url=http://localhost:8086/metrics,task_type=system,le=5 task_executor_run_latency_seconds=12844
prometheus,url=http://localhost:8086/metrics,task_type=system,le=10 task_executor_run_latency_seconds=12864
prometheus,url=http://localhost:8086/metrics,task_type=system,le=+Inf task_executor_run_latency_seconds=74429
prometheus,url=http://localhost:8086/metrics,task_type=system task_executor_run_latency_seconds_sum=4.256783538679698e+11
prometheus,url=http://localhost:8086/metrics,task_type=system task_executor_run_latency_seconds_count=74429
prometheus,url=http://localhost:8086/metrics,taskID=00xx0Xx0xx00XX0x0,task_type=threshold quantile=0.5 task_executor_run_duration=5.178160855
prometheus,url=http://localhost:8086/metrics,taskID=00xx0Xx0xx00XX0x0,task_type=threshold quantile=0.9 task_executor_run_duration=5.178160855
prometheus,url=http://localhost:8086/metrics,taskID=00xx0Xx0xx00XX0x0,task_type=threshold quantile=0.99 task_executor_run_duration=5.178160855
prometheus,url=http://localhost:8086/metrics,taskID=00xx0Xx0xx00XX0x0,task_type=threshold task_executor_run_duration_sum=2121.9758301650004
prometheus,url=http://localhost:8086/metrics,taskID=00xx0Xx0xx00XX0x0,task_type=threshold task_executor_run_duration_count=570
```

[](#view-version-2-tables-when-queried-from-influxdb)

View version 2 tables when queried from InfluxDB

| _time | _measurement | url | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | http://localhost:8086/metrics | go_memstats_alloc_bytes_total | 1422764240.0 |

| _time | _measurement | url | _field | _value |
| --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | http://localhost:8086/metrics | go_memstats_buck_hash_sys_bytes | 5259247.0 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | 0.25 | task_executor_run_latency_seconds | 4413 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | 0.5 | task_executor_run_latency_seconds | 11901 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | 1 | task_executor_run_latency_seconds | 12565 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | 2.5 | task_executor_run_latency_seconds | 12823 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | 5 | task_executor_run_latency_seconds | 12844 |

| _time | _measurement | task_type | url | le | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | +Inf | task_executor_run_latency_seconds | 74429 |

| _time | _measurement | task_type | url | _field | _value |
| --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | task_executor_run_latency_seconds_sum | 425678353867.9698 |

| _time | _measurement | task_type | url | _field | _value |
| --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | system | http://localhost:8086/metrics | task_executor_run_latency_seconds_count | 74429 |

| _time | _measurement | task_type | taskID | url | quantile | _field | _value |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | threshold | 00xx0Xx0xx00XX0x0 | http://localhost:8086/metrics | 0.5 | task_executor_run_duration | 5.178160855 |

| _time | _measurement | task_type | taskID | url | quantile | _field | _value |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | threshold | 00xx0Xx0xx00XX0x0 | http://localhost:8086/metrics | 0.9 | task_executor_run_duration | 5.178160855 |

| _time | _measurement | task_type | taskID | url | quantile | _field | _value |
| --- | --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | threshold | 00xx0Xx0xx00XX0x0 | http://localhost:8086/metrics | 0.99 | task_executor_run_duration | 5.178160855 |

| _time | _measurement | task_type | taskID | url | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | threshold | 00xx0Xx0xx00XX0x0 | http://localhost:8086/metrics | task_executor_run_duration_sum | 2121.9758301650004 |

| _time | _measurement | task_type | taskID | url | _field | _value |
| --- | --- | --- | --- | --- | --- | --- |
| 2021-01-01T00:00:00Z | prometheus | threshold | 00xx0Xx0xx00XX0x0 | http://localhost:8086/metrics | task_executor_run_duration_count | 570 |

#### Related

-   [Prometheus data model](https://prometheus.io/docs/concepts/data_model/)
-   [Scrape Prometheus metrics](/influxdb/v2/write-data/developer-tools/scrape-prometheus-metrics/)
-   [Work with Prometheus in Flux](/flux/v0/prometheus/)
-   [Telegraf Prometheus input plugin](/telegraf/v1/plugins/#input-prometheus)
-   [Scrape data using InfluxDB scrapers](/influxdb/v2/write-data/no-code/scrape-data/)
-   [prometheus.scrape() function](/flux/v0/stdlib/experimental/prometheus/scrape/)

[prometheus](/influxdb/v2/tags/prometheus/)