Returns time series

POST {{baseUrl}}/series?start=irure&end=irure&match[]=irure

The following endpoint returns the list of time series that match a certain label set.

You can URL-encode these parameters directly in the request body by using the POST method and Content-Type: application/x-www-form-urlencoded header. This is useful when specifying a large or dynamic number of series selectors that may breach server-side URL character limits.

The data section of the query result consists of a list of objects that contain the label name/value pairs which identify each series.

Request Params

KeyDatatypeRequiredDescription
startstringStart timestamp. Optional.
endstringEnd timestamp. Optional.
match[]string(Required) Repeated series selector argument that selects the series to return. At least one match[] argument must be provided.

Example: ?' --data-urlencode 'match[]=up' |

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{"status":"success","data":[{"__name__":"up","job":"prometheus","instance":"localhost:9090"},{"__name__":"up","job":"node","instance":"localhost:9091"},{"__name__":"process_start_time_seconds","job":"prometheus","instance":"localhost:9090"}]}