用途:把运维问题转成范围明确、带证据的查询,用于排查运行中 Convex 部署的日志与健康情况,例如哪些函数报错、部署后什么开始失败、某次调用为何失败,以及部署与故障的因果关系。
主要能力:基于官方 Convex MCP 的只读工具(logs、insights、functionSpec、status),提供三种视图——failures(按函数与错误信息分组统计失败并给首个堆栈)、health(cloud 环境最近 72 小时的读限流/OCC 事件)、trace(按 requestId 或函数读完整执行链)。输出节省 token,每条答案附证据(计数与代表性日志/堆栈)及人工可核验的 dashboard.convex.dev 深链。
使用方式:先按 deploy-guard 步骤 0-1 确认并声明所读部署,保持只读;查询前用 functionSpec、status 发现真实函数与字段名;再取有界近期窗口并客户端过滤:logs 仅支持 --history <n>(数量而非时间窗)、--success、--jsonl、--prod、--deployment;insights 无函数过滤,仅限 cloud 的 dev/prod 与用户鉴权。每个问题只选一种视图,不盲目扩散调用。回答格式为一行结论、证据、可核验深链,不做原始日志堆砌。
适用场景:线上故障排查、部署后回归确认、单次调用失败追踪、近期性能与成本线索发现。
限制:logs 与 insights 均无服务端的状态、函数、requestId 或时间窗过滤,需取近期窗口后在客户端过滤;无工具返回仪表盘链接,需由部署名与函数自行构造;性能与成本根因及修复、代码缺陷、持续监控分别交由 convex-advisor、convex-reviewer/convex-authz、monitor/sentinel;本技能始终只读,不执行任何变更,也不开启生产变更标志。