mcpField
G
grafana-billing

grafana-billing

github.com/nodnarbnitram云与 DevOps1667 次安装27 周前更新
代码仓库

关于 grafana-billing

通过 Grafana 数据源代理 API 获取 Prometheus 和 Loki 计费相关指标的 Claude 技能，可查询 staging 与 prod，并用于分析成本和用量。

主要功能

  1. 01查询 Prometheus 计费指标
  2. 02查询 Loki 摄入与存储指标
  3. 03选择 staging 或 prod
  4. 04支持 JSON 输出以供自动化处理
  5. 05比较不同环境的用量

适用场景

  1. 01检查可观测性用量和成本
  2. 02分析 Prometheus 序列基数
  3. 03检查 Loki 摄入量与存储
  4. 04比较 staging 和 prod 指标

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/nodnarbnitram/claude-code-extensions --skill grafana-billing

安装后在 Claude Code 中输入/grafana-billing确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
billing-metrics.md
scripts/
billing_metrics.py
formatters.py
grafana_client.py
loki_metrics.py
prometheus_metrics.py

详细介绍

Grafana 计费指标技能

通过 Grafana 的数据源代理 API 查询 Prometheus 和 Loki 的关键计费指标。

快速开始

# Query both staging and prod (default)
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py

# Query specific environment
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --env staging
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --env prod

# JSON output for automation
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --json

# Filter to specific service
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --service prometheus
uv run .claude/skills/grafana-billing/scripts/billing_metrics.py --service loki

必需的环境变量

  • GRAFANA_STAGING_API_KEY - staging Grafana 工作区的 API 密钥
  • GRAFANA_PROD_API_KEY - prod Grafana 工作区的 API 密钥

捕获的关键指标

Prometheus
指标描述
活跃时间序列当前活跃序列数量（计费维度）
每秒样本数写入速率（DPM = 每秒样本数 * 60）
TSDB 存储磁盘上的存储字节数
基数最高项按序列数量排名前 10 的指标
Loki
指标描述
写入速率每天写入的数据量（GB）
总字节数累计接收的字节数
活跃流活跃日志流的数量
内存块保存在内存中的块

适用场景

当用户询问以下内容时，使用此技能：

  • 可观测性计费或成本
  • 活跃时间序列数量
  • Prometheus 基数分析
  • Loki 写入速率
  • 指标或日志的存储用量
  • 对比 staging 与生产环境的用量

Claude 使用说明

  1. 运行计费指标脚本以收集当前数据
  2. 以清晰、格式良好的方式呈现结果
  3. 指出任何值得关注的指标（基数过高、增长过快）
  4. 如果查询了两个环境，则对比 staging 与 prod
  5. 如果指标异常偏高，则提出成本优化建议

关键规则

  • 运行前务必检查是否已设置 API 密钥
  • 需要以编程方式处理输出时，使用 --json 标志
  • 默认同时查询两个环境以进行对比
  • 妥善处理错误——缺少数据源不应导致脚本崩溃

评论

支持 Markdown