Returns time series
DELETE {{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.
NOTE: These API endpoints may return metadata for series for which there is no sample within the selected time range, and/or for series whose samples have been marked as deleted via the deletion API endpoint. The exact extent of additionally returned series metadata is an implementation detail that may change in the future.
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"}]}