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.