SuperAPI AI 工具集

supabase-incident-runbook

智能体与模型

查看项目

更新于 10-15 23:29

技能介绍

用途:面向 Supabase 后端应用故障的结构化响应流程,适用于生产环境报错、API 响应变慢、连接池耗尽、RLS 静默过滤数据、Edge Function 冷启动失败、存储上传下载异常等场景。

主要能力:分三层排查。第一步分诊平台与应用,先查官方状态页,再用 SDK 健康检查确认连通性与延迟;第二步用 pg_stat_activity 检查连接状态、发现卡住查询与连接泄漏,并评估连接数余量;第三步调试 RLS 策略、查看 Edge Function 日志与冷启动、验证存储桶读写,最后汇总证据包用于向 Supabase 支持升级。

使用方式:需具备 Supabase 项目与仪表盘访问权限、项目内安装 @supabase/supabase-js v2+、安装 Supabase CLI 以读取 Edge Function 日志、直连数据库字符串用于 psql 诊断,并可访问 status.supabase.com。示例命令:curl -sf https://status.supabase.com/api/v2/status.json | jq '.status';Edge Function 日志可用 npx supabase functions logs。完整可复制诊断块位于 references/diagnostics.md,示例位于 references/examples.md。

限制:资料未提供具体价格、平台支持范围或效果保证;部分步骤依赖直连数据库与 CLI 权限,若直连被阻断需改用连接池端口 6543。常见错误处理涵盖连接被拒、连接池耗尽、RLS 权限拒绝、Edge Function WORKER_LIMIT、JWT 过期、存储对象不存在与 429 限流等。