Convex 运行调查 · 确认部署,选择视图,再交付有范围的证据

@public/convex-insights

查看空间 →

面向运行中Convex应用的只读调查流程,先发现真实部署和函数,再选失败、健康或请求追踪其中一个视图,限量读取并在本地筛选。返回有覆盖范围的计数、代表日志及可核实链接;与持续事件监控不同,不启动循环监控,也不把部署时间相关性写成因果。

能力与使用条件

适用场景

  • 按真实函数名或requestId调查最近可见失败
  • 阅读健康洞察并把性能/成本问题交给相应诊断
  • 对照错误起点和版本时间形成可复核的部署相关性说明

输入要求

  • 明确的项目/部署和读取权限、可用MCP工具或CLI版本
  • 单一调查问题及函数名/requestId等已发现标识
  • 有上限的日志窗口、脱敏规则和期望证据范围

输出结果

  • 一句话发现及对应部署/观察窗口
  • 本地筛选后的分组计数与代表性错误/日志证据
  • 可核实的dashboard链接或明确缺失说明、后续调查指针

前置条件

  • 来源根LICENSE为Apache-2.0;此Skill组织已有Convex MCP/CLI读取能力,自身不提供日志后端或持续监控服务
  • 先通过status/functionSpec等能力发现目标和实际schema;命令行flags不能直接当成MCP参数,工具名/可用性按宿主版本核对
  • 具备相关部署的读取权限;生产MCP默认受限,官方生产访问开关会暴露更广能力,须使用最小工具集合及明确授权,不能把它等同只读沙箱

不适用场景与限制

  • 来源混用MCP名称与CLI语法;--history是条数而非时间区间,服务端过滤与insights支持范围依实际版本确认,不能臆造status/function/requestId过滤参数
  • 本地筛选只覆盖已经读取的有限窗口,未出现错误不证明无故障;计数不是完整时段总量,截断/保留期/权限会影响观察
  • 生产访问权限与操作的只读意图不同,禁用写工具/目标限制需独立设置;不为调查自动开启生产写权限或调用mutation
  • 来源称insights为cloud dev/prod与user-auth受限,不能假设自托管、任意deploy key或所有预览均支持同一健康数据
  • dashboard链接由agent根据已确认部署构造,并非工具返回的验证事实;缺标识或无法核实时明确说明,不伪造链接成功
  • 部署时间与失败起点只表明相关,不证明根因;性能/费用分析、代码修复和长期监控分别交接,不作为这次只读调查副作用
  • 本次核对核心、官方MCP和CLI资料,未连接Convex、读取真实日志/洞察、生成真实故障结论或修复部署;配图仅展示流程
  • 下载链接为固定提交的完整仓库快照,使用其中 skills/convex-insights 目录。配图是说明性示例。

说明性示例

  • 调查部署后某函数报错时,先确认部署与真实函数名,再读取有限最近日志并本地分组,给出计数与一条脱敏代表堆栈。比较时间只标记相关性,说明窗口外未知;dashboard链接未核实时明确标注,修复另行授权。

资料依据

  • https://github.com/convex/agent-skills/blob/3fa4a566ba5d843d8a3db303983839ba93e8531d/skills/convex-insights/SKILL.md
  • https://github.com/convex/agent-skills/blob/3fa4a566ba5d843d8a3db303983839ba93e8531d/LICENSE

外部资源

内容由外部网站提供,平台不保证第三方文件的完整性、可用性或安全性。

外部文件的访问权限由第三方管理,本站无法限制其地址的访问。