首页/云/可观测性速查/Loki 标签设计原则
日志平台52 条

Loki 标签设计原则

标签决定数据分片与索引体积:用低基数、稳定的维度(集群/环境/服务/级别),高基数内容放日志正文;标签爆炸是 Loki 故障的常见源头。

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

设计对照

设计对照
# 推荐(低基数、稳定)
{cluster="dc1", env="prod", app="api", level="error"}

# 避免(高基数/易变)
# {request_id="a1b2...", user_id="9527", path="/order/12345"}
# 这些字段应作为日志正文或解析后字段使用,而不是流标签
标签集合决定“流”的数量:过多流会命中 max_streams 限额,写入与查询都会变慢。

易错点

  • 把动态值拼进标签(如路径 ID)会让流数量指数级膨胀
  • 修改标签方案等于改变流身份,历史数据不会自动重新归属

数据来源与参考

  • Grafana 官方文档 · Labels best practices
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌