SuperAPI AI 工具集

planetscale-traffic-control-recommendations

数据与分析

查看项目

更新于 10-25 10:40

技能介绍

用途 该技能面向 PlanetScale Postgres,用于制定 Traffic Control 预算与规则的建议方案,以保护关键流量免受失控查询、流量突增、批处理作业、智能体(agent)和第三方集成影响。按资料要求,它只给出建议,不创建或更改预算,未获批准不执行变更。

使用前提 仅适用于 PlanetScale Postgres。在推荐规则前需检查:当前预算与规则、Insights 查询模式、当前查询标签、应用路由与作业、已知关键路径、已知高开销非关键路径、活跃故障或近期异常。若缺少查询标签,应优先建议补充标签,除非确有已知问题查询需要立即使用针对指纹的规则。

可识别的候选流量切片 导出、报表、搜索接口、管理后台、回填任务、worker 与队列、第三方 webhook、BI 工具、智能体生成的读查询、高频轮询、已知高开销查询指纹、波动大的客户触发接口。

预算模式建议顺序 先以 warn 模式用于常规上线;观察告警与误报;调整标签、指纹与阈值;只有在明确批准并具备紧急回滚路径时才转为 enforce。除非存在活跃故障且操作者明确要求紧急缓解,否则不建议直接以 enforce 起步。

规则策略 标签稳定且有界时优先用标签规则,例如 source=agent、source=bi、feature=export、feature=report、route=/admin/reports、job=DailyBackfill、service=analytics-worker。当特定查询模式危险、标签缺失或不可靠、来源难以归属时,使用指纹规则。对实质不同的流量类别分别建立预算,不要将无关流量合并到一个预算中,以免掩盖资源消耗来源。

建议的默认预算模式(作为推荐模式而非直接套用的数值)

  • 智能体预算:目标为 source=agent 或 source=mcp 的查询,意图防止智能体挤占应用流量,从 warn 起步,建议智能体优先使用只读副本与只读范围,写操作需人工批准。
  • 导出与报表预算:目标为 feature=export、feature=report 或特定报表路由/作业,防止客户触发的报表耗尽数据库资源,先 warn,观察后可考虑 enforce。
  • 后台作业预算:目标为 worker 服务、队列或作业标签,防止回填与重试挤占交互流量,先 warn,确认队列背压行为后再 enforce。
  • 第三方集成预算:目标为 source=integration、合作方有界标签或入站集成调用的路由模板,隔离不可预测的合作方行为,先 warn。
  • 已知指纹预算:目标为特定高开销查询指纹,在代码或 schema 修复期间遏制已知异常查询,紧急情况外先 warn。

“按每个标签值”策略 当 PlanetScale 支持针对所选标签的每个唯一值分别应用预算时,可对有界标签建议使用,如 application、service、归一化后的 route、job、feature、source。不建议用于无界标签,如用户 ID、请求 ID、原始租户 ID、邮箱、UUID 或原始 URL。

限制与注意事项 每条建议都必须说明:Traffic Control 限制资源使用,但不能替代查询调优;它不是 Web 应用防火墙;不替代应用层限流;限制是护栏,并非对所有故障模式的精确保证;糟糕的标签会导致糟糕的规则;enforce 模式可能拒绝查询并影响应用行为。

输出格式 每个拟议预算需包含:预算名称、目标分支、模式(off/warn/enforce)、匹配流量切片、规则类型(tag、fingerprint、keyspace、query kind)、拟议标签或指纹、限额依据、Insights 中支持该建议的查询、安全风险、测试与观察计划、回滚计划、批准要求。最后需注明:未创建、更新、删除或强制执行任何 Traffic Control 预算或规则。

适用场景与限制 适合数据库管理员和后端团队在 PlanetScale Postgres 上规划流量治理、隔离智能体与报表类负载、保护关键交互路径时使用。资料未提供该技能的具体安装命令、收费信息或界面操作步骤,相关事实暂未提供。