Skip to main content
GET
List Prometheus label values

Restrictions

Usage

  • Pass the target data source ID in the X-DSID header. It must belong to the authenticated account and be a Prometheus data source; use /monit/datasource/list to obtain its ID.
  • When the data source restricts querying to certain teams, only members of those teams, its managing team, and account owners or admins can query it; others get 403. An unknown data source ID returns 400.
  • The 200 body is the data source’s native Prometheus HTTP API payload, not the standard { request_id, data } envelope. Query-string parameters are forwarded unchanged, so Prometheus’s own parameters such as match[], start, and end work.
  • When X-DSID is omitted, or any monit-edge of the data source’s cluster is older than v0.35.0, the request is answered by the platform’s own Prometheus instead of your data source. Send the header and keep monit-edge up to date to get your data source’s values.
  • Failures raised before the data source is reached are returned as text/plain with the matching 4xx or 5xx status. A status of 400 or above returned by the data source itself is passed through with its own body.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Headers

X-DSID
string

Data source ID to query, as a decimal string. Must reference a Prometheus data source owned by the authenticated account. When omitted, the request is served by the platform's own Prometheus instead of one of your data sources.

Path Parameters

label_name
string
required

Label name to enumerate values for, for example job.

Response

Native Prometheus label-values response returned by the data source.

Native Prometheus HTTP API response returned by the queried data source. This endpoint does not wrap the payload in the Flashduty response envelope.

status
enum<string>
required

Prometheus result status. success carries data; error carries errorType and error.

Available options:
success,
error
data
string[]

Label values, present when status is success.

One label value.

errorType
string

Prometheus error class, present when status is error.

error
string

Human-readable Prometheus error message, present when status is error.