SuperAPI AI 工具集

gamma-observability

部署与运维

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Gamma API 集成建立监控、日志、健康检查与仪表盘,并形成含指标定义、告警/仪表盘、阈值测试、负责人和复核日期的监控回执。日志与告警需排除私密内容、查看者身份与令牌。

主要能力:通过封装客户端采集请求数、错误数(按状态码)、生成数、完成数、失败数、总积分与总延迟,并计算平均延迟、错误率、完成率和平均每次生成积分;输出结构化 JSON 日志(事件如 generation.started、generation.completed、generation.failed,不记录 apiKey 和原始内容);提供 /health/gamma 健康检查(正常/降级/不可用,超过 5 秒为降级);提供 /metrics/gamma 的 Prometheus 文本指标;并给出错误率、健康检查失败、积分消耗过快、完成率过低的 Prometheus 告警规则示例。

使用方式:需要可用的 Gamma 集成(见 gamma-sdk-patterns)、监控栈(Prometheus/Grafana、Datadog 或 CloudWatch)与日志基础设施。基础 API 地址为 https://public-api.gamma.app/v1.0,请求头使用 X-API-KEY。完成生成后需调用 recordCompletion() 传入积分消耗,否则生成相关指标缺失;轮询结果需回填指标。

关键阈值参考:API 错误率 <5% 健康、5–10% 警告、>10% 严重;健康检查延迟 <2s、2–5s、>5s;生成完成率 >90%、80–90%、<80%;积分消耗按预算;平均生成时间 <30s、30–60s、>60s。

限制与说明:Gamma 不暴露限流响应头或内部指标,故监控完全依赖调用侧埋点;健康检查使用 themes 端点探测;具体框架适配、仪表盘模板与阈值需按自身用量校准,资料未提供价格、配额与官方 SLA。后续可参考 gamma-incident-runbook 处理事件响应。