Prometheus

Monitor metrics, look up values over time, and check the health of monitored systems.

Retrieve active Prometheus alerts and their states.

Response

{
  "alerts": [
    {}
  ],
  "status": "abc123xyz"
}

List the systems Prometheus monitors (scrape targets) and whether each is healthy.

Parameters

Parameter	Type	Required	Description
`state`	string	No	Filter targets by state: active or dropped. Leave blank to include all.

Response

{
  "status": "abc123xyz",
  "targets": [
    {}
  ]
}

Run a Prometheus query (PromQL) and get the latest metric values.

Parameters

Parameter	Type	Required	Description
`query`	string	Yes	The Prometheus query (PromQL) to run.
`time`	string	No	The point in time to check, for example 2026-07-15T09:00:00Z. Leave blank to use the current time.

Response

{
  "result": [
    {}
  ],
  "resultType": "abc123xyz",
  "status": "abc123xyz"
}

Run a Prometheus query (PromQL) and get metric values across a time window.

Parameters

Parameter	Type	Required	Description
`query`	string	Yes	The Prometheus query (PromQL) to run.
`start`	string	Yes	When the time window starts, for example 2026-07-15T09:00:00Z.
`end`	string	Yes	When the time window ends, for example 2026-07-15T17:00:00Z.
`step`	string	Yes	How far apart each data point should be, for example 5m for every 5 minutes or 1h for every hour.

Response

{
  "result": [
    {}
  ],
  "resultType": "abc123xyz",
  "status": "abc123xyz"
}