SuperAPI AI 工具集

vercel-observability

部署与运维

查看项目

更新于 10-15 23:30

技能介绍

用途:为 Vercel 部署搭建完整可观测性,从函数级指标到终端用户体验监控,涵盖分析、运行时日志、日志外发与分布式追踪。

主要能力:1)在仪表盘启用 Web Analytics(Core Web Vitals、页面浏览)与 Speed Insights,并在 Next.js 根布局加入 <Analytics />、<SpeedInsights />,安装 npm install @vercel/analytics @vercel/speed-insights。2)运行时日志:vercel logs <url> --follow,可按 --level=error 过滤,或用 API 拉取部署事件。3)结构化 JSON 日志:在函数中输出带 level、requestId、duration、timestamp、region、env 的 JSON。4)Log Drains:将运行时、构建、静态 CDN、防火墙日志发往 Datadog、Axiom、Sentry、Grafana Loki 或任意 HTTPS/NDJSON 端点,可经仪表盘或 API 创建。5)OpenTelemetry:在 instrumentation.ts 中用 NodeSDK 与 OTLPTraceExporter 导出 trace,并在 next.config.js 开启 experimental.instrumentationHook。6)Sentry 错误跟踪:npx @sentry/wizard@latest -i nextjs,在 sentry.client.config.ts 初始化 dsn、environment、release 与 tracesSampleRate。

适用场景:Next.js 等 Vercel 应用的监控看板、告警阈值(错误率、P95 延迟、冷启动、构建成功率、LCP、边缘缓存命中率)与分布式系统追踪。

限制:Log Drains 与延长日志保留需 Vercel Pro 或 Enterprise;免费日志保留时间较短;外部日志服务、OpenTelemetry SDK、Sentry 均为可选依赖;需配置相应环境变量与令牌。文中未提供具体价格与配额信息。