otel-nextjs-style
面向 Next.js/Vercel 应用的 OpenTelemetry 接入风格指南,核心是使用框架入口 instrumentation.ts 与 @vercel/otel 的 registerOTel 完成引导,而不是自定义 NodeSDK。内容涵盖:在引导中为 Anthropic 等 LLM 提供方接入 OpenInference 插桩并保持调用点原生;在自动插桩覆盖不到的路由处理器中使用 @superlog/otel-helpers 的 withSpan 创建业务 span,并配合 @opentelemetry/api 的 tracer/meter 记录指标;使用 @opentelemetry/api-logs 输出结构化日志而非 console.info;通过源码级公开配置常量(端点与只写公开 token,token 必须以 x-api-key 头传递)显式传给 registerOTel。还说明了 @vercel/otel 1.x 与 2.x 在日志处理器选项单复数上的差异、不要在 NEXT_RUNTIME 后守卫 registerOTel、避免重复上报 provider/model/token 属性、不在路由中计算 LLM 成本,以及用仓库已有工具做冒烟检查。
部署与运维371 次安装