SuperAPI AI 工具集

pscale-insights

通用与其它

查看项目

更新于 10-16 07:17

技能介绍

用途:通过 PlanetScale 服务端对生产流量的分析,排查查询性能与 schema 健康,补充 pscale inspect 的时点、连接级检查。

主要能力:pscale insights queries 按累计执行时间等指标排名查询,支持 totalTime、count、errorCount、rowsRead、rowsReturned、rowsAffected、rowsReadPerReturned、p50Latency、p99Latency、maxLatency、cpuTime、ioTime、lastRun 等排序键,默认 --sort totalTime --dir desc --limit 15。可用 fingerprint 与 keyspace 深入 queries samples、queries show、queries summary、queries traffic-budgets。tags 与 tags summaries 按 sqlcommenter 与系统标签归因负载;errors 与 errors show 查看聚合失败与单次失败执行;anomalies 与 anomalies show 查看资源异常及相关查询;recommendations 与 recommendations show 查看数据库级 schema 建议及拟议 DDL。

用法:命令形如 pscale insights queries <database> <branch> --org <org> --format json;samples 需同时传 fingerprint 与 keyspace,--keyspace 为必填。建议始终显式传 --org,并优先 --format json 以保留完整规范化 SQL、指标与 DDL。使用 Insights 返回的精确 query ID、fingerprint、keyspace,标识符按原样转发。

限制与安全:查询样本可能含敏感 SQL、用户名、地址或标签值,勿直接粘贴到公开处。异常相关性只是调查证据,非因果证明。建议中的 DDL 是提案而非自动执行指令,执行前需确认引擎、keyspace/schema、表与生产目标,评估锁与运行影响,取得明确批准并保留回滚方案;dismiss 也是写操作,需确认组织、数据库与建议序号并说明理由。分支级洞察返回 not-found 可能表示数据库/分支不存在或未启用 Query Insights,需先核实。相关技能:pscale-inspect、pscale-sql、pscale-deploy-request。