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=jsonl | JSON 行输出,便于 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 rule | Loki 也支持 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 requests | querier 并发超限,错峰查询或扩容 | |
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) → 对比发布前后| 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 预聚合
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 面试复习。