logql.query_range() 函数

logql.query_range() 在给定的时间范围内从指定的 LogQL 查询中查询数据，按查询、时间范围和可选的 limit 表达式过滤数据。所有值都作为字符串值返回（在 csv.from 中使用 raw 模式）

函数类型签名

(
    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

参数

url

LogQL/qryn URL 和端口。默认为 http://qryn:3100。

path

LogQL query_range API 路径。

limit

查询限制。默认为 100。

query

(必填) 要执行的 LogQL 查询。

start

结果中包含的最早时间。默认为 -1h。

结果包括与指定的开始时间匹配的点。使用相对持续时间或绝对时间。例如，-1h 或 2022-01-01T22:00:00.801064Z。

end

结果中包含的最新时间。默认为 now()。

结果排除与指定的停止时间匹配的点。使用相对持续时间或绝对时间。例如，-1h 或 2022-01-01T22:00:00.801064Z。

step

查询分辨率步长（秒）。默认为 10。

仅适用于生成矩阵响应的查询类型。

orgid

可选的 Loki 组织 ID，用于分区。默认为 ""。

示例

从 LogQL/qryn 查询测量中的特定字段

import "contrib/qxip/logql"

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

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