用途:为 Groq API 故障提供快速应急响应流程。Groq 是第三方推理供应商,故障时的缓解手段为等待、回退到其他模型或回退到其他供应商。
主要能力:按五个阶段推进事件处理——分级(P1–P4,P1 响应预算小于 15 分钟,P4 为下一工作日)、诊断(状态可达性、鉴权、各模型可用性、限流响应头)、决策(依据 HTTP 状态码选择动作路径)、缓解(单模型 5xx 时回退模型路由,429 时等待或改路由,401 时轮换密钥,Groq 整体故障时启用回退供应商)、沟通与关闭(内部告警、状态页更新、证据收集与复盘)。
使用方式:需在运行诊断命令的环境中导出 GROQ_API_KEY,准备 curl 用于 API 探测,仅在从 Kubernetes 收集日志时需要 kubectl,并需可访问 console.groq.com 以轮换密钥或升级套餐;若需完全脱离 Groq,还需配置回退供应商(如 OpenAI)。所有调用使用 Authorization: Bearer $GROQ_API_KEY 鉴权,密钥应存放于密钥管理器,不要内联。常用探测命令:curl -s -o /dev/null -w "%{http_code}\n" https://api.groq.com/openai/v1/models -H "Authorization: Bearer $GROQ_API_KEY"。详细内容分布在 references/ 下的 triage-and-diagnostics.md、mitigations.md、communication-and-postmortem.md。
输出:诊断结论、已应用的缓解措施、沟通记录、证据包(groq-incident-TIMESTAMP.tar.gz,含 models.json 与脱敏后的 app-logs.txt)以及复盘文档。
限制:具体命令、脚本与模板细节需查阅上述参考文件;资料未提供完整代码示例与全部参数说明。