Grafana Loki 日志聚合代理

解决的问题

传统日志系统依赖全文索引，导致存储成本高且运维复杂。在多租户环境中，日志隔离和路由规则易出错，且难以关联分布式追踪数据，故障排查效率低。

核心能力与关键步骤

• Promtail 配置：自动生成 promtail-config.yml，定义日志源、标签和管道，支持容器和系统日志采集。
• LogQL 查询：提供查询模板，例如 sum by (service) (rate({namespace="prod"} |= "error")))，快速定位错误服务。
• 多租户路由：通过 tenant_id 标签隔离日志，例如 route_by_tenant("team-a", "team-b")，确保各团队日志独立存储和查询。
• 保留策略：设置日志生命周期，例如 retention_policy("30d")，避免长期存储占用资源。
• Tempo 关联：生成 tempo-config.yml，在日志中注入 trace_id，例如 link_trace("span_id")，实现日志与追踪的交叉跳转。

适用边界与注意点

• 依赖 Docker Driver Client：需在 Docker 环境中安装该插件，否则无法直接采集容器日志。
• 无全文索引：Loki 仅索引元数据，复杂文本搜索需依赖 LogQL 过滤，可能影响查询性能。
• 多租户配置复杂：需严格管理 tenant_id 标签，避免跨租户数据泄露。
• Tempo 集成限制：需确保 Tempo 与 Loki 版本兼容，否则关联查询可能失败。