GeekIt

LogQL命令速查

日志流选择、行过滤、json/logfmt 解析、标签过滤、count/rate、unwrap 聚合、API 与 logcli、性能与报错等 120 条查询

共 120 条查询 · 12 类场景 · 点击右侧图标可复制

查询 / 表达式说明复制
{app="nginx"}按标签选择日志流,最基础的查询
{namespace="prod", app="api"}多标签组合,逗号表示与关系
{app=~"api|web"}正则匹配多个值,正则默认整体锚定
{app!="debug"}排除指定标签值
{app!~"test-.*"}正则排除
{namespace="prod"} |= "error"选择器 + 行过滤,最常用组合
{job=~".+"}匹配所有非空值;不能用 .* 这类可匹配空值的表达式
{app="api", pod=~"api-7d9f.*"}按 Pod 名前缀过滤,K8s 排障常用
{app="api"} |= "error" != "ignore"包含 error 且不含 ignore
查询 / 表达式说明复制
|= "timeout"包含子串(大小写敏感)
!= "healthcheck"不包含子串
|~ "error|fail|exception"正则匹配,比子串灵活但更耗 CPU
!~ "debug|trace"正则排除
|= "(?i)error"正则内联忽略大小写
|> "<_> level=error <_>"模式匹配(Loki 3.0),比正则更快
|= "a" |= "b" |= "c"链式过滤,从左到右依次收窄
|= "error" != "error_count"先包含后排除,控制误报
过滤条件越多越靠前越好行过滤在读取后执行,先写最能筛掉的子串
查询 / 表达式说明复制
| json把 JSON 日志的顶层字段解析为标签
| json level="severity", msg="message"重命名解析出的字段
| logfmt解析 key=value 格式日志
| logfmt --strict严格模式,格式不符直接报错
| regexp `(?P<ip>\d+\.\d+\.\d+\.\d+)`正则提取命名分组为标签,反引号字符串免转义
| pattern "<ip> - - \"<method> <uri> <_>\" <status> <size>"模式解析 nginx 访问日志,<_> 表示跳过
| unpack解析 Promtail 打包的 _entry 字段
| syslog解析 RFC5424 syslog(3.0+)
解析失败会产生 __error__ 标签用 | __error__="" 过滤掉解析失败的行
| json | line_format "{{.method}} {{.uri}}"解析后重排输出格式
查询 / 表达式说明复制
| json | level="error"解析出字段后按标签等值过滤
| json | level=~"error|fatal"标签正则过滤
| json | status >= 500数值比较,常用于状态码
| json | status >= 500 and status < 600组合条件(2.9+)
| json | duration > 1s时长比较,自动识别单位
| json | level="error" or level="fatal"或条件
| json | __error__=""过滤掉解析失败的行
| json | line_format "{{.level}} {{.msg}}"自定义输出行内容
| json | label_format svc="{{.app}}-{{.env}}"用模板生成新标签
| json | label_format dst=src复制标签值
| json | drop trace_id, span_id丢弃不关心的标签(2.9+)
| json | keep level, msg只保留指定标签(2.9+)
查询 / 表达式说明复制
count_over_time({app="api"} |= "error" [5m])5 分钟内匹配的日志行数
rate({app="api"}[5m])每秒日志行数
rate({app="api"} |= "error" [5m])每秒错误日志数,做错误曲线
bytes_over_time({app="api"}[5m])区间内日志字节数
bytes_rate({app="api"}[5m])每秒日志字节数,评估日志量成本
sum by (level) (count_over_time({app="api"} | json [5m]))按 level 统计日志量
sum(rate({app="api"}[5m])) / sum(rate({app="api"} |= "error" [5m]))总日志与错误日志的比值
absent_over_time({app="api"}[5m])5 分钟内没有任何日志时返回 1,做静默告警
count_over_time 与 rate 都要求区间向量写成 count_over_time({app="api"}) 会直接报语法错误
查询 / 表达式说明复制
sum(count_over_time({app="api"} | json | level="error" [5m]))全局错误总数
topk(5, sum by (pod) (rate({app="api"} |= "error" [5m])))错误最多的 5 个 Pod
avg_over_time({app="api"} | json | unwrap duration [5m])提取数值字段求平均
quantile_over_time(0.99, {app="api"} | json | unwrap duration [5m]) by (pod)按 Pod 求 P99 耗时
sum_over_time({app="api"} | json | unwrap bytes [1h])区间累加
max_over_time({app="api"} | json | unwrap duration [1h])区间最大值
min_over_time / stddev_over_time / first_over_time / last_over_time其它区间聚合函数,语义与 PromQL 一致
| unwrap duration | __error__=""过滤非数值导致的 unwrap 错误
unwrap 后必须紧跟区间聚合直接 unwrap 不聚合会报错或结果为空
by (pod) 放在聚合函数外层分组位置写错会变成全局聚合
查询 / 表达式说明复制
sum(rate({app="api"}[5m])) / sum(rate({app="api"} |= "error" [5m])) * 100错误率百分比
count_over_time({app="api"}[5m]) offset 1h与 1 小时前对比
sum(rate({app="api"}[5m])) - sum(rate({app="api"}[5m] offset 1d))与昨天同时段做差
log 查询与指标查询可以二元运算两侧标签集必须能匹配,否则报 many-to-many
sum by (job) (rate({job=~"api|web"}[5m]))多流汇总后按 job 分组
vector(1)生成常量向量,用于对齐或占位
or 表示并集两个查询结果合并,常用于多环境聚合
查询 / 表达式说明复制
{namespace="prod", app="nginx"} |~ ` 5[0-9][0-9] `筛选 nginx 5xx 访问日志(反引号正则免转义)
{app="nginx"} | pattern "<ip> - - \"<method> <uri> <_>\" <status> <_>" | status >= 500解析访问日志后按状态码过滤
{namespace="prod", pod=~"api-.*"} |= "panic"查找服务 panic 日志
{app="api"} | json | level="error" | line_format "{{.ts}} {{.msg}}"结构化错误日志只看关键字段
sum by (level) (count_over_time({app="api"} | json [1h]))按级别统计近 1 小时日志量
{app="api"} | json | status >= 500 | line_format "{{.uri}} {{.status}}"按 URI 排查 5xx 接口
quantile_over_time(0.95, {app="api"} | json | unwrap duration [5m]) by (pod)按 Pod 统计慢请求 P95
{app="sshd"} |= "Failed password"排查 SSH 暴力破解
{namespace="prod"} |= "OOMKilled"查找容器 OOM 记录
{app="api"} |= "context deadline exceeded"查找超时错误
{app="api"} |= "error" | line_format "{{ __line__ }}"输出原始日志行
用 $app 变量配合 Grafana 下拉面板中写成 {app="$app"} 实现动态切换
查询 / 表达式说明复制
curl -G http://loki:3100/loki/api/v1/query_range --data-urlencode 'query={app="api"} |= "error"' --data-urlencode 'start=1h' --data-urlencode 'limit=100'范围查询日志(start 支持相对时间)
curl -G http://loki:3100/loki/api/v1/query --data-urlencode 'query=sum(rate({app="api"}[5m]))'即时指标查询
curl -s http://loki:3100/loki/api/v1/labels获取全部标签名
curl -s http://loki:3100/loki/api/v1/label/app/values获取某标签的所有取值
curl -s 'http://loki:3100/loki/api/v1/series?match[]={app="api"}'查看匹配的日志流
curl -G http://loki:3100/loki/api/v1/index/stats --data-urlencode 'query={app="api"}' --data-urlencode 'start=1h'估算扫描的字节数与流数量,评估查询成本
curl -G http://loki:3100/loki/api/v1/tail --data-urlencode 'query={app="api"}'实时跟踪日志(类 tail -f)
logcli query '{app="api"} |= "error"' --since=1h --limit=100命令行查询,排障比 UI 更快
logcli query '{app="api"}' --since=30m --output=jsonlJSON 行输出,便于 jq 处理
logcli labels app列标签值
logcli series '{app="api"}'列出匹配的流
logcli stats 'sum(rate({app="api"}[5m]))'查看查询扫描量
查询 / 表达式说明复制
{app="$app"} |= "$keyword"变量注入,面板可切换应用与关键字
label_values({namespace="prod"}, app)Grafana 变量:列出 app 取值
$__auto日志面板自动步长,避免区间过大
sum by (level) (count_over_time({app="$app"} | json [$__auto]))随时间变化的日志量曲线
Logs 面板配 Explore 做临时排查先 Explore 验证语句再固化到面板
变量 All 值要配置为 .+否则 {app=~"$app"} 匹配不到任何流
面板里少用超宽时间范围日志查询成本与时间范围成正比,容易超时
查询 / 表达式说明复制
{app="api", namespace="prod"} |= "error"尽量用等值标签而非正则,减少流匹配
|= "error" 优于 |~ "error"子串匹配比正则快很多
|> "<_> level=error <_>" 优于正则模式匹配更省 CPU
把过滤放在解析之前先减少行数再 json/logfmt 解析,明显降低开销
| json | __error__=""避免解析失败行进入后续计算
限制返回条数 --limit 100日志查询默认上限有限,明确 limit 避免拉全量
高基数标签不要放日志标签里trace_id、user_id 放正文用解析器提取,避免流爆炸
重复查询固化为 recording ruleLoki 也支持 rules,把常用聚合预计算
curl /loki/api/v1/index/stats 评估成本上线面板前先确认扫描量
查询 / 表达式说明复制
parse error at line 1, col X: syntax error: unexpected IDENTIFIER语法错误:引号、括号或管道顺序不对
queries require at least one regexp or equality matcher that does not have an empty-compatible value选择器太宽(如 {app=~".*"}),换成具体值或 .+
many-to-many matching not allowed二元运算两侧标签集冲突,先 sum by 统一维度
maximum of series (500) reached for a single query匹配流过多:加等值标签或收窄正则
context deadline exceeded查询超时:缩小时间范围、减少正则、提高 limit 限制
too many outstanding requestsquerier 并发超限,错峰查询或扩容
pipeline error: expecting label name标签过滤语法错误,检查 | 后的字段名
unwrap value is not a number字段不是数值:先 | json 确认类型,或过滤异常值
__error__ 标签频繁出现解析器与日志格式不匹配,用 | __error__="" 排查剩余行
line_format 输出为空模板里的字段未解析成功,先确认 json/logfmt 能取到
regexp 里反斜杠要转义JSON 与 shell 双层转义,必要时改用 pattern 解析
entry too far behind写入时间戳过旧,被 Loki 拒绝(超过 max_chunk_age)
查询结果缺日志检查方向 direction、limit、时间范围与标签选择器
标签名与解析字段同名解析出的字段会覆盖或冲突,用 json level="severity" 重命名

运维常用组合

接口错误排查{app="api"} |= "error" → | json → | status >= 500 → | line_format "{{.uri}} {{.status}}"
日志量看板sum by (level) (count_over_time({app="api"} | json [5m])) → rate 曲线 → topk 异常 Pod
慢请求分析| json | unwrap duration → quantile_over_time(0.99, ...) by (pod) → 对比发布前后
nginx 5xx| pattern 解析 → | status >= 500 → sum by (uri) (count_over_time(...)) → 定位接口
静默告警absent_over_time({app="api"}[5m]) → count_over_time 对比基线 → 设置阈值
命令行排查logcli labels → logcli series → logcli query --since=1h --limit=100 → logcli stats 看成本

常见问题排查

1. 先用等值标签收窄

Loki 按流索引,等值标签能把扫描范围缩到最小,正则只用于不得已

2. 过滤放解析前

先用 |= 减少行数,再 json/logfmt 解析,CPU 与内存都会明显下降

3. 高基数不进标签

trace_id、user_id 放日志正文,用解析器临时提取,否则流数量爆炸

4. 正则默认全匹配

=~ 是整体锚定,写 api 只能匹配值为 api 的流,要匹配前缀用 api.*

5. unwrap 必须配聚合

| unwrap 后要跟 avg_over_time 等区间函数,否则语法不成立

6. 成本与时间范围成正比

面板默认时间窗别太大,长周期用 recording rule 预聚合

共 120 条 LogQL 查询 · 示例中的标签名与字段请替换为实际环境

关于LogQL命令速查

在线 LogQL 查询速查手册,按日志流选择器、行过滤、解析器、标签过滤与格式化、计数与速率、聚合与 unwrap、运算与偏移、运维常用查询、Loki API 与 logcli、Grafana 使用、性能成本优化、常见报错与坑等 12 类场景整理 140+ 条查询与表达式,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 {app="nginx"} 与多标签组合与 =~ / != / !~ 与 {job=~".+"}、|= 子串与 != 排除与 |~ 正则与 !~ 与 |> 模式匹配、| json 与 json level="severity" 与 | logfmt 与 logfmt --strict 与 regexp 命名分组与 pattern 模式解析与 unpack 与 syslog、| level="error" 与 level=~"error|fatal" 与 status >= 500 与 and/or 组合与 duration > 1s 与 __error__="" 与 line_format 与 label_format 与 drop/keep、count_over_time 与 rate 与 bytes_over_time 与 bytes_rate 与 absent_over_time、sum/avg/max/min/topk 与 unwrap duration 与 quantile_over_time(0.99, ...) by (pod) 与 sum_over_time 与 stddev_over_time、错误率百分比与 offset 1h 对比、nginx 5xx 与 panic 与 SSH 暴力破解与 OOMKilled 与 context deadline exceeded 等运维查询、/loki/api/v1/query_range 与 query 与 labels 与 label/app/values 与 series 与 index/stats 与 tail 与 logcli query --since --limit --output=jsonl 与 logcli labels/series/stats、Grafana $__auto 与 label_values 与变量 All 值 .+、等值标签优先与子串优先于正则与模式匹配省 CPU 与高基数不进标签与 index/stats 评估成本,以及 parse error、queries require at least one regexp or equality matcher、many-to-many matching、maximum of series (500) reached、context deadline exceeded、pipeline error expecting label name、unwrap value is not a number、entry too far behind 等报错排查。适用于 Loki 日志查询与排障、Grafana 日志面板与告警、Kubernetes 与 nginx 日志分析、结构化日志解析与指标化、日志量与成本治理、logcli 命令行排查,以及运维与 SRE 面试复习。

核心能力

  • 涵盖 {app="nginx"} 与多标签组合与 =~ / != / !~ 与 {job=~".+"}、|= 子串与 != 排除与 |~ 正则与 !~ 与 |> 模式匹配、| json 与 json level="severity" 与 | logfmt 与 logfmt --strict 与 regexp 命名分组与 pattern 模式解析与 unpack 与 syslog、| level="error" 与 level=~"error|fatal" 与 status >= 500 与 and/or 组合与 duration > 1s 与 __error__="" 与 line_format 与 label_format 与 drop/keep、count_over_time 与 rate 与 bytes_over_time 与 bytes_rate 与 absent_over_time、sum/avg/max/min/topk 与 unwrap duration 与 quantile_over_time(0.99, ...) by (pod) 与 sum_over_time 与 stddev_over_time、错误率百分比与 offset 1h 对比、nginx 5xx 与 panic 与 SSH 暴力破解与 OOMKilled 与 context deadline exceeded 等运维查询、/loki/api/v1/query_range 与 query 与 labels 与 label/app/values 与 series 与 index/stats 与 tail 与 logcli query --since --limit --output=jsonl 与 logcli labels/series/stats、Grafana $__auto 与 label_values 与变量 All 值 .+、等值标签优先与子串优先于正则与模式匹配省 CPU 与高基数不进标签与 index/stats 评估成本,以及 parse error、queries require at least one regexp or equality matcher、many-to-many matching、maximum of series (500) reached、context deadline exceeded、pipeline error expecting label name、unwrap value is not a number、entry too far behind 等报错排查

适用场景

适用于 Loki 日志查询与排障、Grafana 日志面板与告警、Kubernetes 与 nginx 日志分析、结构化日志解析与指标化、日志量与成本治理、logcli 命令行排查,以及运维与 SRE 面试复习。LogQL命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

LogQL命令速查是免费的吗?需要注册或安装吗?
LogQL命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
LogQL命令速查支持哪些功能?
涵盖 {app="nginx"} 与多标签组合与 =~ / != / !~ 与 {job=~".+"}、|= 子串与 != 排除与 |~ 正则与 !~ 与 |> 模式匹配、| json 与 json level="severity" 与 | logfmt 与 logfmt --strict 与 regexp 命名分组与 pattern 模式解析与 unpack 与 syslog、| level="error" 与 level=~"error|fatal" 与 status >= 500 与 and/or 组合与 duration > 1s 与 __error__="" 与 line_format 与 label_format 与 drop/keep、count_over_time 与 rate 与 bytes_over_time 与 bytes_rate 与 absent_over_time、sum/avg/max/min/topk 与 unwrap duration 与 quantile_over_time(0.99, ...) by (pod) 与 sum_over_time 与 stddev_over_time、错误率百分比与 offset 1h 对比、nginx 5xx 与 panic 与 SSH 暴力破解与 OOMKilled 与 context deadline exceeded 等运维查询、/loki/api/v1/query_range 与 query 与 labels 与 label/app/values 与 series 与 index/stats 与 tail 与 logcli query --since --limit --output=jsonl 与 logcli labels/series/stats、Grafana $__auto 与 label_values 与变量 All 值 .+、等值标签优先与子串优先于正则与模式匹配省 CPU 与高基数不进标签与 index/stats 评估成本,以及 parse error、queries require at least one regexp or equality matcher、many-to-many matching、maximum of series (500) reached、context deadline exceeded、pipeline error expecting label name、unwrap value is not a number、entry too far behind 等报错排查。
LogQL命令速查适合哪些场景使用?
适用于 Loki 日志查询与排障、Grafana 日志面板与告警、Kubernetes 与 nginx 日志分析、结构化日志解析与指标化、日志量与成本治理、logcli 命令行排查,以及运维与 SRE 面试复习。