Range Query
loki.query_range
ActionBusiness appsconnection required
Calls the Loki API with the connection's credentials.
Evaluate LogQL over a time range.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Username & password
- Providers
- Grafana Loki
- Secret shape
- the password/API key (optional), or {"password": "…"}
- Config it needs
- base_url, user
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 3 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
logql LogQL expression. | string | Yes | — | — | — |
start Range start (RFC3339/unix ns). | string | Yes | — | — | — |
end Range end; the call is refused without it. | string | Yes | — | — | — |
limit How many results one call returns; blank uses Loki's own default. | number | No | — | ≥ 1 | — |
Output
One shape.
result
| Field | Type | Example |
|---|---|---|
result_type | string | — |
result | array | — |
{
"result": [],
"result_type": ""
}Related Grafana Loki nodes
See Range Query run in a workflow.
In a technical demo we add the Grafana Loki connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.