用途:检查 Convex 部署中正在发生的情况,例如失败的 action、参数校验错误、外部 API 返回的 401 未授权,以及哪些函数运行过、耗时多久。
主要能力:流式读取或按历史条数拉取日志;区分 dev 与 prod 部署;查看函数执行的成功/失败;以 JSONL 输出原始日志事件;列出或读取部署的环境变量。
使用方式:需项目使用 Convex 且可用 npx convex,并在包含 convex/ 目录的应用目录下运行。默认针对 dev 部署,生产问题需加 --prod。常用命令:npx convex logs;npx convex logs --prod;npx convex logs --prod --history 30;npx convex logs --prod --history 25 --success;npx convex env list --prod;npx convex env get OA_INTERNAL_KEY --prod。日志选项包括 --prod、--history [n]、--success、--jsonl、--deployment-name <name>、--env-file <path>。
适用场景:用户报告 Convex 错误(如 unauthorized、ArgumentValidationError、action 超时);确认当前使用 dev 还是 prod 部署;查看近期函数执行;排查 OA_INTERNAL_KEY、PUBLIC_API_URL 等环境变量与 API 响应的关联。
限制:Convex action 不读取 .env.local,只能看到部署中设置的环境变量;流式读取超时可用 --history N 改为有限条数后退出;需已登录并链接正确项目。资料未提供收费、价格或平台支持等更多信息。