loki-label-analyzer-grafana-skills

1. 基本信息

项目	内容
名称	loki-label-analyzer-grafana-skills
作者/维护者	Grafana Labs（grafana 官方组织）
来源链接	https://github.com/grafana/skills/tree/main/skills/grafana-cloud/loki-label-analyzer
许可证	Apache-2.0（GitHub API 获取，仓库级）
GitHub Stars / Forks	合集仓库整体 203 / 17（GitHub API 获取；该数字属整个 grafana/skills 合集，不代表本技能自身热度，取证方式见第 7 章）
最新版本	SKILL.md 未单列版本号，随所属 grafana-cloud 插件组（marketplace.json 声明 version 0.1.0）一起发布
安装方式	Claude Code 插件市场 / `npx skills add`（详见第 10 章）

2. 功能介绍与亮点

loki-label-analyzer 把 Grafana Labs Professional Services 的 Loki 标签设计审计方法论封装成结构化流程，核心分四块：

基数评估框架：按标签基数（从 env 这类个位数枚举到 user_id 这类无界值）给出六档判定表，并结合“是否在多数查询里被用作筛选条件”的访问模式对齐检查
受保护标签机制：明确将 service_name、deployment_environment、job 列入白名单，任何整改建议都只能“整治取值”、不得“删除该标签键”，避免破坏 Grafana Cloud 的关联链路、告警与仪表盘
结构化报告输出：强制要求报告包含免责声明、下游依赖核对（告警/仪表盘/LBAC/关联链路是否会被改动影响）、成本影响分析（按 Grafana Cloud 用量数据给出量化档位，数据缺失时降级为定性判断）三个部分，防止产出“只讲道理不谈影响”的空洞建议
可直接使用的 Alloy 配置片段：标签值归一化、结构化元数据迁移、日志行嵌入降基数等常见整改动作均配有可复制的 Grafana Alloy pipeline 代码
性能瓶颈诊断：把查询耗时拆成排队、索引、存储、执行四个阶段，帮助判断“慢查询”到底是标签设计问题还是基础设施问题

3. 适用场景

所属分类：DevOps 与基础设施

适合已在生产环境运行 Grafana Loki 的 SRE / 平台工程师：在查询变慢、日志采集成本超预算、或计划做标签体系重构前，用一句“帮我审计一下这套 Loki 标签策略”即可拿到包含具体整改动作和影响评估的结构化报告，替代过去手工翻文档、自行判读基数指标的流程；也适合刚接手 Loki 运维、缺乏标签设计经验的工程师，作为学习标签设计原则的交互式向导。

4. 跨 Agent 兼容性

Claude Code：原生支持——README 给出具体命令：claude plugin marketplace add grafana/skills 后 claude plugin install grafana-cloud@grafana-skills
Codex：官方支持——README “Codex and other Agent Skills tools” 专节说明技能通过仓库根 .agents-plugin/marketplace.json 清单自动发现，无需手动配置
OpenClaw：未验证——抓取材料未点名，仅笼统声明兼容“任何遵循 Agent Skills 开放标准的工具”
Hermes Agent：未验证，理由同上

5. 推荐理由

标签基数失控是 Loki 生产环境里最容易踩、却最少被系统性检查的坑——直接体现为查询变慢和账单飙升。这个技能把 Grafana 官方专业服务团队沉淀的标签审计方法论变成可复用的结构化流程，产出包含下游依赖核对、迁移代码片段与量化成本影响的完整报告，而不是一句“少用高基数标签”式的笼统提醒。

6. 评分

维度	分数	说明
受欢迎程度	7	Grafana Labs 官方出品，子技能自身有 8 次提交、最近一次为 2026-07-24（3 天前），由两位具名 Grafana Labs 员工（Solutions Architect、Professional Services）持续打磨；所属合集仓库有外部用户在 GitHub Issues 报告过安装路径问题，证明真实使用，但未见该子技能专属的第三方讨论
可用性	8	文档结构完整（核心概念、评估框架、强制报告模板、故障诊断四段式），提供可直接复制的 Alloy 配置代码；维护活跃（3 天前有提交）；核心审计流程不依赖付费的 Grafana Cloud，自托管 Loki OSS 即可使用，仅成本分析这一子项在缺少 Grafana Cloud 用量数据时降级为定性判断
安全性	9	见下方检查清单
综合	8.0	三项均值

安全检查清单：

检查项	结果
① Shell 命令与权限范围	不执行任何 shell 命令，SKILL.md 正文全为分析框架与报告模板说明；文中的 Alloy/LogQL 代码片段是提供给用户手动采纳的配置建议，不由技能自身执行
② 联网外发	无网络请求；成本分析部分仅在用户已自行接入 Grafana Cloud 用量数据时读取该数据作为输入,技能本身不发起抓取或外发
③ 凭据存储	不索取任何 API Key 或凭据
④ 可疑指令	全文为标签评估规则、报告模板与代码示例，未发现提示注入或隐蔽指令；要求原样粘贴的一段免责声明文本是常规商业合规用语，非可疑指令
⑤ 作者信誉	Grafana Labs 为知名开源可观测性厂商，grafana 为其官方 GitHub 组织，两位提交者均实名可查、职位与仓库定位相符
⑥ License	Apache-2.0，明确（仓库级）
⑦ 维护时间	子目录最近一次提交 2026-07-24，仓库整体最近一次提交同日，非弃置项目

7. 跟同类 Skills 相比的优势

方案	定位	差异
loki-label-analyzer（本技能）	交互式标签审计：读取用户实际标签设计，产出含迁移代码与成本影响的结构化报告	个性化诊断+可执行整改方案，而非通用原则罗列
Loki 官方 `logcli series --analyze-labels` 命令	官方 CLI 内置的原始基数统计工具	只输出各标签的基数数字，整改方案与优先级判断需工程师自行完成
Grafana Loki 官方 “Label best practices” 文档	静态参考文档，讲通用标签设计原则	面向所有用户的通用建议，不针对具体标签集给出个性化诊断
prometheus-label-strategy（同合集仓库姊妹技能）	把同一套标签审计方法论应用于 Prometheus 指标而非 Loki 日志	覆盖的可观测性信号不同（指标 vs 日志），审计逻辑相通但基数敏感场景不同

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。

9. 其他补充

所属 grafana/skills 仓库工程实践成熟：配备“Validate Marketplace”（清单校验）与“Lint Skills”（代码检查）两条 CI 工作流、Renovate 自动依赖更新机器人、按插件分组的 CODEOWNERS。仓库同时收录 Prometheus、Tempo、Mimir、Pyroscope、k6 等 LGTM 可观测性全家桶其他组件的同类技能，供后续按需组合安装。

10. 安装使用方式

Claude Code：

claude plugin marketplace add grafana/skills
claude plugin install grafana-cloud@grafana-skills

注意：该命令会安装 grafana-cloud 插件组下全部技能（共 18 个），非仅 loki-label-analyzer 一个。

Codex 及其他遵循 Agent Skills 标准的工具： 自动发现仓库根目录 .agents-plugin/marketplace.json 清单，无需手动配置；也可用统一命令单独拉取：

npx skills add grafana/skills

Cursor： 同样使用 npx skills add grafana/skills，技能会写入项目 .cursor/skills/ 目录供其 agent 加载。

安装后无需重启；在对话中描述“帮我审计一下 Loki 的标签策略”或“为什么我的 Loki 查询这么慢”即可触发。

11. 注意事项

无法只安装该单个技能——通过 Claude Code 插件市场安装会连带装入 grafana-cloud 插件组下全部 18 个技能
报告模板要求原样粘贴一段 Grafana Labs Professional Services 免责声明，措辞偏商业合规场景，个人/学习用途下这段文本意义不大
成本影响分析在未接入 Grafana Cloud 用量数据时只能给出定性档位，无法给出精确金额
OpenClaw / Hermes Agent 的兼容性未见官方声明，跨 agent 使用前建议自行验证