用途:帮助为 Grafana Loki 生成生产可用的 LogQL 查询,覆盖调试、告警、仪表盘指标与故障排查场景。触发示例包括“按服务写错误率 LogQL”“构建 Loki 告警查询”“把排查需求转成 LogQL”。
主要能力:支持日志查询与指标查询;按顺序执行固定流程,先收集目标、时间窗口、流选择器标签、日志格式与已知字段,再确认 Loki/Grafana 版本与部署环境,随后给出计划并选择输出模式。默认仅输出最终查询,也可选择逐步增量构建模式。可生成流选择、行过滤、解析(json、logfmt、pattern、regexp、decolorize、unpack)、指标聚合(rate、count_over_time、bytes_over_time、sum_over_time、quantile_over_time 等)、格式化与标签操作、告警表达式。复杂查询要求先读取本地参考文件 examples/common_queries.logql 与 references/best_practices.md,读取不可用时会说明并改用兼容性优先的保守查询并标注未经验证。外部文档查询优先使用 Context7,其次 WebSearch,且优先官方 Grafana/Loki 文档。
使用方式:按阶段回答澄清问题;若 AskUserQuestion 不可用,则用纯文本继续。版本未知时默认使用兼容性优先语法,避免 3.x 专属特性,并可另行提供 3.x 优化变体。输出会附带运行方式(Grafana Explore/面板或 logcli)、可调项、假设与兼容性说明。
适用场景:Loki 日志查询编写、仪表盘指标、告警规则、排查分析。
限制:需要用户提供标签、日志格式与版本等信息,缺失字段会追问或以显式假设继续;未提供具体价格、平台支持范围与效果数据。