google-ai-usage-monitor

📊 Google AI 智能用量监控与预警

基于 OpenClaw 生态的 Google AI Studio 用量监控方案,实时追踪 Gemini API 配额消耗并自动预警,帮助团队避免服务中断并优化调用成本。

收藏
1.4k
安装
538
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

该 Skill 提供了一套完整的 Google AI Studio (Gemini API) 用量监控解决方案。通过浏览器自动化技术,定期抓取 Google AI Studio 控制台中的用量数据,监控关键指标包括每分钟请求数 (RPM)、每分钟令牌数 (TPM) 和每日请求数 (RPD)。系统支持 Free、Pay-as-you-go 及 Paid Tier 等多种计费层级的限额追踪,并能自动生成结构化的 Discord 报告,在用量超过阈值时触发分级告警(50% 警告、80% 紧急预警)。用户可通过配置 Cron 任务实现每日定时检查,无需手动登录控制台即可掌握 API 消耗趋势。

显著优点方面,首先覆盖全面的监控指标,不仅追踪基础请求量,还深入到令牌级别,帮助开发者精准把握大模型调用的资源消耗。其次,灵活的告警机制支持自定义阈值,通过 Discord 集成实现即时通知,避免配额耗尽导致的服务中断。再者,提供了即插即用的报告模板和自动化脚本示例,大幅降低部署门槛。最后,与 OpenClaw 生态深度整合,支持 browser 工具自动化数据采集,适合无服务器环境下的定时监控场景。

潜在缺点或局限性在于,该 Skill 本质为文档型配置指南,并非开箱即用的 SaaS 服务,需要用户自行部署浏览器自动化环境并维护 Cron 任务。数据获取依赖 Google AI Studio Web 界面的解析,存在约 15 分钟的延迟,无法满足实时监控需求。此外,由于依赖浏览器渲染,若 Google 更新控制台界面结构,可能导致数据抓取失效。T3 来源等级也意味着需要用户自行验证配置安全性。

适合的目标群体主要面向使用 Gemini API 的开发团队、技术运维人员及产品经理。特别适合处于 Free 或 Pay-as-you-go tiers、配额敏感的小中型团队,以及需要向 Discord 频道自动同步用量状态的分布式团队。对于需要监控多项目 API 消耗的企业管理员,该 Skill 提供了标准化的监控框架。

使用该 Skill 需注意以下风险:一是凭证安全风险,配置中涉及的 Google Project ID 和 Discord Webhook URL 需通过环境变量安全存储,避免硬编码泄露;二是浏览器自动化风险,建议使用专用浏览器 profile 并限制权限范围,防止恶意脚本利用;三是数据准确性风险,由于依赖界面解析而非官方 API,可能存在抓取失败或数据偏差;四是权限管理风险,需确保监控账号具有访问 Usage Dashboard 的权限,同时避免过度授权。

安全解读

核心用法

Google AI Usage Monitor 是一款面向开发团队的 Gemini API 用量监控方案,通过浏览器自动化工具定时抓取 Google AI Studio 用量面板数据,实现配额消耗的可视化追踪与智能预警。

工作流程:配置 Project ID → 定时打开用量面板 → 解析 RPM/TPM/RPD 三指标 → 计算使用率 → 生成 Markdown 报告 → 按阈值分级推送至 Discord。

关键指标监控

  • RPM(每分钟请求数峰值):反映瞬时流量压力
  • TPM(每分钟 Token 数峰值):衡量模型计算负载
  • RPD(每日请求总数):控制成本上限

分级预警机制:<50% 正常运行、50-80% 黄色关注、>80% 红色紧急告警,支持 @mention 即时通知。

显著优点

1. 零代码架构:纯 Markdown 文档 + 浏览器自动化指令,无需部署额外服务或编写脚本
2. 官方数据源:直接读取 Google AI Studio 官方用量面板,数据权威实时

3. 灵活集成:提供 Discord 模板、Cron 配置、Heartbeat 检测三位一体的 DevOps 方案

4. 多层级适配:覆盖 Free/Pay-as-you-go/Paid Tier 1 三种计费档位的差异化限额

潜在局限

  • UI 依赖风险:Google AI Studio 用量面板的 DOM 结构变更会导致解析失效,需人工维护选择器
  • 异步加载延迟:面板数据需等待 5-10 秒加载,极端情况下可能超时
  • 15 分钟数据延迟:Google 官方标注用量数据更新存在 15 分钟滞后
  • 账号依赖:需保持浏览器会话登录状态,多账号切换场景配置复杂

适合人群

  • 使用 Gemini API 的中小开发团队
  • 需要成本预警但不想投入开发资源的个人开发者
  • 已有 OpenClaw 生态集成的组织用户

常规风险

  • 误告警风险:数据延迟可能导致 80% 阈值触发时实际已超限
  • 隐私配置风险:Discord CHANNEL_ID 硬编码存在信息泄露隐患,建议改用环境变量
  • 浏览器会话安全:长期保持 Google 账号登录状态需配合设备安全策略

google-ai-usage-monitor 内容

手动下载zip · 2.7 kB
SKILL.mdtext/markdown
请选择文件