Commit 1b7d9053 authored by Julius Volz's avatar Julius Volz

Improve documentation around time series concepts.

parent 39634193
...@@ -11,18 +11,20 @@ values belonging to the same metric and the same set of labeled dimensions. ...@@ -11,18 +11,20 @@ values belonging to the same metric and the same set of labeled dimensions.
Besides stored timeseries, Prometheus may generate temporary derived timeseries Besides stored timeseries, Prometheus may generate temporary derived timeseries
as the result of queries. as the result of queries.
## Identification ## Metric names and labels
Every time series is uniquely identified by its _metric name_ and a set of Every time series is uniquely identified by its _metric name_ and a set of
_key-value pairs_, also known as _labels_. Changing any label value, including _key-value pairs_, also known as _labels_.
adding or removing a label, will result in a new time series.
Labels enable Prometheus's highly-dimensional data model: any given combination The _metric name_ specifies the general feature of a system that is measured
of labels for the same metric name identifies a particular dimensional (e.g. `http_requests_total` - the total number of HTTP requests received). It
instantiation of that metric (for example: all HTTP requests that used the may contain ASCII letters and digits, as well as underscores and colons. It
method `POST` and which resulted in a `404` response). must match the regex `[a-zA-Z_:][a-zA-Z0-9_:]`.
Metric names may contain ASCII letters, numbers, as well as underscores and Labels enable Prometheus's dimensional data model: any given combination of
colons. They must match the regex `[a-zA-Z_:][a-zA-Z0-9_:]`. labels for the same metric name identifies a particular dimensional
instantiation of that metric (for example: all HTTP requests that used the
method `POST` and which resulted in a `404` response). Changing any label
value, including adding or removing a label, will create a new time series.
Label names may contain ASCII letters, numbers, as well as underscores. They Label names may contain ASCII letters, numbers, as well as underscores. They
must match the regex `[a-zA-Z_][a-zA-Z0-9_]`. must match the regex `[a-zA-Z_][a-zA-Z0-9_]`.
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment