Prometheus
Type ID: prometheus · Kind: Action · Ports: 1 in, 1 out
Query metrics and alerting data from Prometheus.
Credentials
Basic Auth (prometheus), No Auth (prometheus_noauth), Bearer Token (prometheus_bearer), Custom Headers (prometheus_headers)
Resources & operations
- Query (
query)- Instant Query (
instantQuery) - Evaluate a PromQL expression at a single point in time - Range Query (
rangeQuery) - Evaluate a PromQL expression over a time range
- Instant Query (
- Metadata (
metadata)- Get Targets (
getTargets) - Get health and scrape info for monitored targets - Get Alerts (
getAlerts) - Get active alerts and their state
- Get Targets (
For agent integrations (name: 'prometheus' in permissions.integrations), grant '*', a resource key, or an operation key — see Tools and Permissions:
Resource key (<resource>) | Operation keys (<resource>.<operation>) |
|---|---|
query | query.instantQuery, query.rangeQuery |
metadata | metadata.getTargets, metadata.getAlerts |
Properties
Common
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| Resource | resource | options | Yes | query | Query (query), Metadata (metadata) | - |
| Operation | operation | options | Yes | instantQuery | Instant Query (instantQuery), Range Query (rangeQuery) | resource = query |
| Operation | operation | options | Yes | getTargets | Get Targets (getTargets), Get Alerts (getAlerts) | resource = metadata |
Query → Instant Query
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| PromQL Expression | query | string | Yes | '' | PromQL expression to evaluate, e.g. 100 - (avg(rate(node_cpu_seconds_total{mode="idle"}[5m])) * 100) | resource = query, operation = instantQuery |
| Time | time | string | No | '' | Optional evaluation timestamp (RFC3339 or Unix timestamp). Defaults to now. | resource = query, operation = instantQuery |
Query → Range Query
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| PromQL Expression | query | string | Yes | '' | PromQL expression to evaluate over the time range, e.g. rate(http_requests_total{code="500"}[5m]) | resource = query, operation = rangeQuery |
| Start Time | start | string | Yes | '' | Start timestamp (RFC3339 or Unix timestamp) | resource = query, operation = rangeQuery |
| End Time | end | string | Yes | '' | End timestamp (RFC3339 or Unix timestamp) | resource = query, operation = rangeQuery |
| Step | step | string | Yes | 1m | Query resolution step width, e.g. 1m, 1h | resource = query, operation = rangeQuery |
Metadata → Get Targets
| Property | Key | Type | Required | Default | Possible values | Applies when |
|---|---|---|---|---|---|---|
| State | state | options | Yes | any | Any (any), Active (active), Dropped (dropped) | resource = metadata, operation = getTargets |
Metadata → Get Alerts
(No additional properties)
Notes
- Instant Query and Range Query output:
{ resultType, result }. - Get Targets output:
{ activeTargets, droppedTargets }. - Get Alerts output:
{ alerts }.