Skip to content
For LLMsView as Markdown·

Prometheus

Query metrics, inspect targets, and manage alerts with the Prometheus HTTP API.

DetailValue
CategoryMonitoring
Base URLhttps://prometheus.example.com/api/v1
AuthenticationBasic Auth
Endpoints8
Connector keyprometheus

Using Prometheus in a workflow

  1. Go to Connections and click New Connection.
  2. Pick Prometheus from the marketplace.
  3. Enter your credentials (see Authentication above for what's expected).
  4. In a workflow, drop an API Call node and select this connection.
  5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

EndpointSummary
GET /queryEvaluate instant query
GET /query_rangeEvaluate range query
GET /seriesFind time series
GET /labelsList label names
GET /label/{label_name}/valuesList label values
GET /targetsList targets
GET /rulesList rules
GET /alertsList active alerts

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /query

Evaluate instant query

DetailValue
Operation IDmonitoring.instantQuery
MethodGET
Path/query

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.instantQuery.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /query_range

Evaluate range query

DetailValue
Operation IDmonitoring.rangeQuery
MethodGET
Path/query_range

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.rangeQuery.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /series

Find time series

DetailValue
Operation IDmonitoring.findSeries
MethodGET
Path/series

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.findSeries.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /labels

List label names

DetailValue
Operation IDmonitoring.listLabelNames
MethodGET
Path/labels

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.listLabelNames.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /label/{label_name}/values

List label values

DetailValue
Operation IDmonitoring.listLabelValues
MethodGET
Path/label/{label_name}/values

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.listLabelValues.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /targets

List targets

DetailValue
Operation IDmonitoring.listTargets
MethodGET
Path/targets

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.listTargets.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /rules

List rules

DetailValue
Operation IDmonitoring.listRules
MethodGET
Path/rules

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.listRules.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.

GET /alerts

List active alerts

DetailValue
Operation IDmonitoring.listAlerts
MethodGET
Path/alerts

Parameters

No parameters.

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Prometheus connection from the Connection dropdown.
  3. In the Operation dropdown, select monitoring.listAlerts.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Prometheus API reference.