用途:面向 Klaviyo API 中断与集成故障的快速应急响应,把“Klaviyo 坏了”转化为明确的严重级别、已执行的缓解措施和书面复盘。
主要能力:提供快速分诊脚本与决策树,回答四个问题——Klaviyo 自身是否宕机、能否认证、是否被限流、自身应用是否健康;按状态码区分故障类型(401/403 认证、429 限流、400、5xx 服务端错误);给出 P1–P4 严重级别与响应时间目标(P1 完全中断 <15 分钟,P2 服务降级 <1 小时,P3 轻微影响 <4 小时,P4 无用户影响至下一工作日);提供按错误类型的缓解命令、内部与外部沟通模板及事后复盘模板。
使用方式:需在 shell 中导出 KLAVIYO_PRIVATE_KEY(pk_ 开头的私有 API 密钥),并具备 curl 与 python3;需能访问应用健康端点,最好有 Prometheus 指标;需可访问 Klaviyo 控制台以轮换密钥;应用需携带 Klaviyo 要求的 revision 头(本手册固定为 2024-10-15)。先运行分诊脚本,再按决策树分类、定级、执行缓解,最后沟通并撰写复盘。示例命令:curl -s "https://status.klaviyo.com/api/v2/status.json" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d['status']['description'])";以及带 Authorization: Klaviyo-API-Key $KLAVIYO_PRIVATE_KEY 与 revision: 2024-10-15 请求 https://a.klaviyo.com/api/accounts/ 查看 HTTP 状态码。
适用场景:Klaviyo 相关宕机、API 报错排查、限流与延迟升高、Webhook 延迟、监控缺口与弃用警告等。
限制:完整分诊脚本、逐错误缓解命令与沟通/复盘模板位于 references/ 目录,本文件仅为高层流程;状态页不可达时建议改用移动网络或查看 @klaviyo;指标不可用时改用 cURL 直连 API;密钥轮换需预先有备份与文档化流程;告警阈值应基于基线调优。数据处理的细节参见 klaviyo-data-handling 技能。