Vercel 可观测性配置与排障
在 Vercel 上做日志、链路、Web Analytics、Speed Insights 和错误监控的接入,或用来排查线上卡住、变慢、报错的具体原因。
功能与用途
Vercel 可观测性配置与线上排障指南。用于在 Vercel 部署的应用中接入结构化日志、Drains 传输、Web Analytics、Speed Insights 与 OpenTelemetry 链路追踪,并能通过 REST API 流式拉取运行时日志,排查线上请求挂起、超时与报错问题。
适用场景
- 线上接口卡死与耗时排查:在路由与 Server Action 中埋入规范结构化日志,通过请求 ID 与耗时定位卡点。
- 用户体验与性能指标监测:接入 Web Analytics 与 Speed Insights,收集真实用户访问与核心性能指标数据。
- 运行时日志流式拉取与监控:配置 Next.js instrumentation 钩子或利用 REST API 流式读取部署事件排查故障。
适用人群
- 在 Vercel 上部署应用的 Next.js 开发
- 负责线上故障排查的值班工程师
- 需要给产品补埋点的前端工程师
使用步骤
- 先说明是接入监控还是排障,并给出项目框架和部署信息;排障时先确认目标接口有没有结构化日志。
- 让它补齐最小日志基线:请求开始与结束都打一条结构化 JSON,带上请求 ID、路由和耗时,出错时打 error 级别。
- 需要看线上日志时,用部署事件接口按流式方式拉取,务必设置超时并逐行解析 NDJSON,避免占用无限连接。
- 需要用户行为与性能数据时,安装并接入 Web Analytics、Speed Insights,需要业务事件再补自定义埋点与服务端上报。
- 需要统一监控时通过 Next.js 的 instrumentation 注册入口初始化监控,也可以接 Sentry、Datadog 等第三方方案。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-18
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Vercel Observability expert guidance — Drains (logs, traces, speed insights, web analytics), Web Analytics, Speed Insights, runtime logs, custom events, OpenTelemetry integration, and monitoring dashboards. Use when instrumenting, debugging, or optimizing application performance and user experience on Vercel.
使用前准备
- 项目需部署在 Vercel 上
- 调用运行时日志接口需自备 VERCEL_TOKEN,或通过 Vercel MCP 的日志查询工具访问。
依赖与权限
- VERCEL_TOKEN
- DRAIN_SECRET
- ERROR_WEBHOOK_URL
- NEXT_PUBLIC_DD_CLIENT_TOKEN
- 读取用户主动提供的内容