---
title: logql.query_range() function
description: logql.query_range() queries data from a specified LogQL query within given time bounds, filters data by query, timerange, and optional limit expressions. All values are returned as string values (using raw mode in csv.from)
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/qxip/logql/query_range/
estimated_tokens: 1473
product: Flux
version: v0
---

# logql.query\_range() function

-   Flux 0.192.0+
-   View InfluxDB support

`logql.query_range()` is a user-contributed function maintained by the [package author](#package-author-and-maintainer).

`logql.query_range()` queries data from a specified LogQL query within given time bounds, filters data by query, timerange, and optional limit expressions. All values are returned as string values (using `raw` mode in `csv.from`)

##### Function type signature

```js
(
    query: string,
    ?end: A,
    ?limit: B,
    ?orgid: string,
    ?path: string,
    ?start: C,
    ?step: D,
    ?url: string,
) => stream[E] where A: Timeable, B: Stringable, C: Timeable, D: Stringable, E: Record
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### url

LogQL/qryn URL and port. Default is `http://qryn:3100`.

### path

LogQL query\_range API path.

### limit

Query limit. Default is 100.

### query

(Required) LogQL query to execute.

### start

Earliest time to include in results. Default is `-1h`.

Results include points that match the specified start time. Use a relative duration or absolute time. For example, `-1h` or `2022-01-01T22:00:00.801064Z`.

### end

Latest time to include in results. Default is `now()`.

Results exclude points that match the specified stop time. Use a relative duration or absolute time. For example, `-1h` or `2022-01-01T22:00:00.801064Z`.

### step

Query resolution step width in seconds. Default is 10.

Only applies to query types which produce a matrix response.

### orgid

Optional Loki organization ID for partitioning. Default is `""`.

## Examples

### Query specific fields in a measurement from LogQL/qryn

```js
import "contrib/qxip/logql"

option logql.defaultURL = "http://qryn:3100"

logql.query_range(query: "{job=\"dummy-server\"}", start: -1h, end: now(), limit: 100)
```

[inputs](/flux/v0/tags/inputs/)