SuperAPI AI 工具集

ramp-observability

部署与运维

查看项目

更新于 10-15 23:28

技能介绍

用途:为 Ramp 集成添加可观测性,同时监控传输层健康与业务完整性。低错误率并不足够,若事件缺失、对象未同步或出现重复财务影响,仍属异常。

主要能力:定义请求成功率与延迟、Webhook 接收/处理延迟、队列年龄、延迟任务年龄、同步完整性、重复抑制、对账新鲜度等目标;输出方法加路径模板、状态类、环境、实体代理、trace ID、尝试次数、延迟、页数、事件类型、事件 ID 哈希与发布版本,且不含敏感值;跟踪未同步与失败对象、未匹配 ERP 引用、Webhook 对账缺口、挂起 worker、生产写入联锁状态等业务状态指标;按症状与业务影响告警,附运行手册链接、负责人、环境、受影响实体/对象类与安全诊断查询;用沙箱事件与故障注入测试仪表盘和告警,验证遥测脱敏、基数边界、保留期与事件可用性。

使用方式:先确认 Ramp 应用、环境、业务实体、受影响数据与工作流、负责人与回滚边界;阅读 references/official-docs.md 并复核端点 schema、scope、限制与支持状态;在获批前使用合成夹具或 Ramp 沙箱;准备获批的密钥存储与脱敏证据位置。工具使用上,用 Glob 定位候选代码、清单、夹具与证据,用 Grep 查找端点、字段、权限、标识符、错误与过时假设,用 Read 检查最小必要本地文件,Write 仅用于新的获批本地草稿、测试、配置或证据,Edit 仅用于有已知回滚的受限获批变更。本地文件工具不授权 Ramp 操作,也不替代负责人批准。

适用场景:Ramp API 客户端、Webhook 消费者、延迟任务与会计同步的监控与告警设计。

限制:服务负责人批准 SLO 与告警,安全/隐私批准遥测字段与保留期,财务/数据负责人批准对账阈值;指标全绿但财务报告缺对象时,以对账与源/目标计数为准;标签基数爆炸时用模板、受限类别或单向采样标识符替代原始 ID 与 URL;trace 含令牌或载荷时限制访问、尽量清除、轮换凭据并修复埋点后再启用;未解决的供应商行为、权限或财务状态应视为停止条件。