logcli

Grafana Loki 日志查询客户端

补充说明

logcli 通过 LogQL 查询 Loki 日志，支持实时跟随、标签浏览和 JSON 输出。它适合终端排障和脚本化日志检索。

常用示例

logcli labels
logcli series '{app="api"}'
logcli query '{app="api"}' --since=1h --limit=100
logcli query '{app="api"} |= "error"' --since=30m
logcli query '{app="api"} | json | status >= 500' --since=1h
logcli query '{app="api"}' --tail --follow
logcli query '{app="api"}' --output=jsonl --since=1h
logcli --addr=http://loki:3100 --org-id=tenant-a query '{app="api"}'

易错点与排错

• --addr 要指向 Loki 网关/实例；多租户环境还要 --org-id。
• 时间范围默认有限；大范围查询会被限制，先用 --since 缩小。
• 标签基数过高会拖慢查询；优先用低基数标签过滤。
• --tail --follow 是流式查询，适合实时排障，不适合大范围回溯。
• LogQL 的管道阶段顺序影响结果；| json 后再过滤字段。
• 认证、TLS 和反向代理配置要匹配；401/403 先查 token 和租户。
• 输出格式影响脚本解析；用 jsonl 而不是默认表格。
• 查询超时可能是 Loki 限流或查询范围过大，不是日志不存在。

相关命令

• promtool — Prometheus 查询
• amtool — 告警管理
• otel-cli — 链路埋点