SuperAPI AI 工具集

observability-instrumentation

部署与运维

查看项目

更新于 10-16 08:02

技能介绍

用途:当规模就绪评审或韧性模式要求“加一个指标”时使用本技能;诊断线上故障则改用 debug-runtime。它面向支付、打款、结算、对账、热点接口等路径,先列出运维会问的问题,例如某笔操作是否成功、失败率与 p95、队列深度、对账偏差,再据此埋点。

主要能力:日志采用结构化键值或 JSON,带关联 id 与稳定业务键(交易、账户、幂等键、渠道参考号、租户),记录决策、状态转换与调用边界,禁止记录密钥、卡号、凭证或未脱敏个人信息。指标沿用仓库现有客户端:请求路径用 RED(速率、错误、时长直方图),资源(连接池、工作进程、连接)用 USE(利用率、饱和度、错误);领域信号包括队列深度与等待时长、结算延迟、重试次数、熔断状态、对账偏差、幂等冲突率,按操作与结果打标签并限制基数。追踪需跨任务、队列与调用传播上下文,为每次外部调用建立带时长与状态的 span。告警针对用户可感知的症状(错误率、延迟、积压、偏差),结合 SLO 阈值与燃烧率,写明原因与下一步动作,并删除无用告警。

使用方式:选定路径,列出运维问题,按上述规则补日志、指标与追踪,最后触发该路径验证日志、指标、追踪是否出现,以及失败时告警是否触发。

限制:不得记录密钥、完整卡号、凭证或未脱敏 PII;不得使用无界标签基数(原始 id、邮箱);不得依赖平均延迟,应使用直方图与分位数;不得添加无负责人、无响应动作的告警;不得过度埋点热点路径,必要时采样。