用途:面向 Vercel 可观测性栈的专家指引,涵盖运行时日志、结构化日志、Drains、Web Analytics、Speed Insights 与监控集成。排查问题时先看日志,确认有无日志基线。
主要能力:
- 结构化日志:在 API 路由与 Server Action 中输出 JSON 日志,带 level、msg、route、requestId、耗时等字段。
- 运行时日志:在 Dashboard 查看函数调用实时日志;可用 Vercel CLI 跟踪,或通过 REST API(/v3/deployments/:id/events)以流式 NDJSON 读取,需设置超时。
- Web Analytics:安装 @vercel/analytics,在布局中挂载 <Analytics />;自定义事件与服务器端 track 属 Pro/Enterprise。
- Speed Insights:安装 @vercel/speed-insights,在布局中挂载 <SpeedInsights />,跟踪 LCP、INP、CLS、FCP、TTFB。
- Drains:将日志、追踪(OpenTelemetry)、Speed Insights、Web Analytics 转发到外部端点,支持 JSON、NDJSON、Syslog 格式;需 Pro 或 Enterprise 计划。
使用方式:Drains 可通过 Dashboard(/{team}/~/settings/log-drains)或 REST API(/v1/drains)创建、测试、更新、删除;可用 vercel integration add datadog 等集成自动配置。Drain 负载用 HMAC-SHA1 签名,置于 x-vercel-signature 头,须对原始请求体做时间安全比对。
适用场景:排查函数卡住、变慢或报错;集中式日志与追踪;性能监控;发布前后可观测性预检与错误扫描。
限制:Drains 需 Pro/Enterprise,Hobby 计划只能用 Dashboard、CLI(vercel logs)或 MCP/REST 查询;自定义事件需 Pro/Enterprise;Drain 签名密钥仅在创建时显示一次,丢失须重建;示例中部分版本、价格与具体行为暂未提供。