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
Key | Datatype | Required | Description |
---|---|---|---|
start | string | Start timestamp. Optional. | |
end | string | End 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
Key | Datatype | Required | Description |
---|---|---|---|
Accept | string |
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"}]}