用途:面向运行中的 Convex 应用,用自然语言回答运行状态问题,例如“出了什么错误”“部署后失败的是什么”“为什么这次调用失败”。它是对 Convex 官方 MCP 只读工具(logs、insights、functionSpec、status)的纪律化封装,把运维问题转成范围明确、可返回证据的查询。
主要能力:三种视图——failures 视图用 logs --history <n> --jsonl 后本地筛选失败并按函数与错误信息分组,返回计数与每组首个堆栈;health 视图用 insights(仅云端),查看类型化的 72 小时读取限制与 OCC 事件并排序;trace 视图同样取日志窗口后本地筛到单个 requestId/函数,读取完整执行过程。还可交叉核对部署因果:用日志时间戳与 status 中的部署版本比较失败开始时间。
使用方式:先确认并声明正在读取的部署,读取日志与洞察属只读,绝不为 insights 开启生产变更标志。查询前用 functionSpec 列出真实函数名与状态,不猜测标识符。注意工具限制:logs 只接受 --history <n>(数量而非时间窗口)、--success、--jsonl、--prod、--deployment,没有服务端的状态/函数/requestId/时间过滤;insights 没有函数过滤,且仅限云端开发/生产与用户鉴权。因此取有界的近期窗口后必须在客户端筛选。答案包含一行结论、证据(计数加一条代表性堆栈或日志行),并尽可能给出由部署名加函数构造的 dashboard.convex.dev 深链供人工核验;不返回原始日志转储。
适用场景与限制:适合排障、部署后回归核查与调用链路追踪。每次问题只选一种视图,避免发散调用。性能与成本根因及修复交给 convex-advisor,只作为指针型发现;代码缺陷交给 convex-reviewer/convex-authz,后续实时告警交给 monitor/sentinel。除资料所述外,收费、价格、安装方式等暂未提供。