SuperAPI AI 工具集

turbo-monitor-debug

部署与运维

查看项目

更新于 10-15 21:54

技能介绍

用途:为 Goldsky Turbo 管道提供监控与调试参考,帮助查询 turbo CLI 语法(inspect、logs、list 的标志与选项),并对照错误模式排查故障。交互式诊断请改用 /turbo-doctor。

主要能力:常用命令包括 goldsky turbo list 列出管道、goldsky turbo inspect <name> 查看实时数据、goldsky turbo inspect <name> -n <node> 查看指定节点、goldsky turbo logs <name> 查看日志,并支持 --follow、--timestamps、--tail N、--since N 等选项。实时 Inspect TUI 支持 Tab/方向键切换标签、1-9 跳转、j/k 滚动、/ 搜索、n/N 切换匹配、d 切换定义、w 打开 Web 仪表盘、e 打开 Web 编辑器、q 或 Ctrl+C 退出。管道更新、暂停、恢复或暂时不可用时 TUI 会自动重连并保留已接收数据,30 分钟不可达后自动关闭。

错误参考:data/ 目录下 error-patterns.json 收录已知错误模式、原因与解决方案。常见模式包括 connection refused(数据库不可达,检查网络/防火墙)、authentication failed(凭据错误,更新 secret)、secret not found(用 goldsky secret create 创建)、SQL syntax error(修正 YAML 中 SQL 后重新部署)、duplicate key(确保转换中主键唯一)、script transform error(检查脚本逻辑、空值处理与返回类型)、dynamic_table error(确认后端 secret/表存在)、WASM execution failed(检查未定义访问)、handler timeout(增大 timeout_ms 或修复端点)。脚本转换需注意空值检查、返回类型与 schema 字段完整、定义 invoke(data)、使用 BigInt() 构造。动态表需先在 PostgreSQL 建表,内存压力大时改用 postgres 后端。

用法:可用 ./scripts/analyze-logs.sh <pipeline-name> 或加 --tail 100 分析日志,脚本会检查常见错误模式并给出建议。

限制:资料未提供安装方式、收费与平台支持信息;具体错误细节以 data/ 目录文件为准。