Logs 面板是什么
Logs 面板把日志行直接嵌进看板，数据源通常是 Loki 或 Elasticsearch，实现「指标异常、原始日志同屏可查」，省掉在 Grafana 与日志系统之间来回切换的时间。典型布局是上面一排指标趋势、下方三分之一放同服务的日志面板，时间范围与模板变量自动联动，看到毛刺立刻能往下看当时的报错内容。
基本信息
| 适用平台 | Grafana 8+，需配置 Loki 或 Elasticsearch 日志数据源 |
|---|---|
| 查询语言 | Loki 用 LogQL，Elasticsearch 用 Lucene 或 KQL |
| 常用选项 | Wrap lines、Show time、Deduplication、Limit |
| 性能提醒 | 日志查询比指标重，刷新间隔不宜过小 |
典型使用场景
- 故障同屏：错误率出现毛刺时，下方直接看该服务当时的 error 日志
- 发布验证：发布窗口内按版本字段过滤日志，确认新版本没有新增报错
- 单请求排查：按 trace_id 过滤，把一次慢请求的相关日志行拉齐
- 值班看板：核心错误行常驻，值班人不必打开独立日志系统
- 容量巡检：日志量与错误类型分布和指标放在同一时间轴上对照
LogQL 与面板选项
LogQL 与面板选项
{app="api"} |= "error" | json | level="error"
# 面板选项：Wrap lines 自动换行、Show time 显示时间列
# Deduplication 去重、Limit 控制单屏行数
# 变量联动：{app="$app"} |= "$keyword"
# Elasticsearch 数据源写 Lucene：service:"api" AND level:error面板选项与建议
| 选项 | 作用 | 建议 |
|---|---|---|
| Wrap lines | 长行自动换行 | 排查堆栈报错时必开 |
| Show time | 显示时间列 | 与指标对齐时间点时必开 |
| Deduplication | 相同内容去重 | 重试风暴场景能省掉大量噪声 |
| Limit | 单次返回行数 | 按屏幕高度设置，别一次拉几千行 |
日志面板的查询成本高于指标，挂在 30 秒自动刷新的看板上会持续压后端；建议把日志面板单独放一张看板，或把刷新间隔降到 1 分钟以上。
接入步骤
- 先确认日志数据源已配置且能返回结果，避免把数据源问题误判成面板问题
- 在 Explore 里把 LogQL 或 Lucene 调通，确认过滤条件命中的正是目标日志
- 回到看板新建 Logs 面板并粘贴同一条查询，核对时间范围与指标面板一致
- 打开 Wrap lines 与 Show time，长堆栈与时间对齐这两项基本都要开
- 把面板排到指标下方三分之一处，形成从指标异常到原始日志的下钻路径