首页/云/可观测性速查/LogQL unwrap:对数值字段做统计
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条
日志平台52 条
链路追踪23 条告警与响应50 条

LogQL unwrap:对数值字段做统计

unwrap 把行内解析出的数值字段当成样本值:从此可以对日志里的耗时、字节数求平均值、分位数,而不再只统计条数。

可观测性速查云更新于 2026-10-12

数值统计示例

数值统计示例
# 请求耗时的 P95(从 JSON 字段取数)
quantile_over_time(0.95, {app="api"} | json | unwrap duration_ms [5m]) by (route)

# 响应体大小均值
avg_over_time({app="api"} | logfmt | unwrap bytes [1m])
一次查询只能有一个 unwrap;字段非数值时该行被跳过并计入错误指标,先验证解析结果。

易错点

  • 字段里混入空值或字符串会让统计结果偏差,抽样验证字段质量
  • unwrap 配合高基数分组(如路径参数)可能产生大量序列,注意查询上限

数据来源与参考

  • Grafana 官方文档 · LogQL unwrap
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌