守护进程现可向 Vercel Tracing 发送追踪数据
内容提要
Vercel守护进程现可向Vercel Tracing发送OpenTelemetry追踪数据，让用户和代理在项目追踪中查看后台工作进程的运行情况。Vercel为每个守护进程提供Unix套接字接收OTLP/HTTP追踪，路径由环境变量设置。将@vercel/otel升级至2.3.0以上即可自动导出Node.js守护进程追踪，需在工作进程启动前初始化OpenTelemetry。可通过Vercel CLI按服务名搜索并返回JSON。
延伸解读
守护进程追踪的接入方式
Vercel 为每个守护进程提供 Unix 套接字接收 OTLP/HTTP 追踪，路径由 VERCEL_OTEL_SOCKET_PATH 环境变量指定。将 @vercel/otel 升级至 2.3.0 以上后，默认配置即可自动导出 Node.js 守护进程的追踪数据。关键点在于必须在工作进程启动前初始化 OpenTelemetry，否则可能无法正确采集。
与项目追踪的统一查看
守护进程的追踪数据会进入 Vercel Tracing，与项目其他部分的追踪并列展示。这意味着后台工作进程的运行情况不再孤立，用户和代理可以在同一视图中检查守护进程的 span。对于依赖后台任务的场景，这种统一视图有助于定位跨进程的问题。
通过 CLI 检索守护进程追踪
Vercel CLI 支持按服务名在项目内搜索追踪，并返回 JSON 格式，方便代理程序消费。示例命令可检索最近一小时的守护进程 span。这一能力将追踪数据的用途从人工排查扩展到自动化分析，但需注意搜索范围默认是最近一小时。
Q&A
Vercel 守护进程现在能向 Vercel Tracing 发送什么数据？
Vercel 守护进程现在可以发送 OpenTelemetry 追踪数据到 Vercel Tracing，让用户和代理能够查看后台工作进程的运行情况，并与项目其他追踪数据一起分析。
如何让 Node.js 守护进程自动导出追踪数据到 Vercel？
将 @vercel/otel 升级到 2.3.0 或更高版本，并在工作进程启动前初始化 OpenTelemetry（例如调用 registerOTel 并指定 serviceName），SDK 会自动检测 Unix 套接字并将 span 发送到 Vercel。
Vercel 如何接收守护进程的追踪数据？
Vercel 为每个守护进程提供一个 Unix 套接字来接收 OTLP/HTTP 追踪数据，套接字路径通过环境变量 VERCEL_OTEL_SOCKET_PATH 设置。
怎样通过 Vercel CLI 搜索守护进程的追踪数据？
可以使用命令 `vercel traces search --project my-project --service my-daemon --json`，按服务名在项目中搜索并返回 JSON 格式的追踪数据，默认搜索最近一小时的守护进程 span。
使用守护进程追踪功能需要满足什么前提条件？
需要将 @vercel/otel 升级到 2.3.0 或更高版本，并在工作进程启动前初始化 OpenTelemetry，同时确保环境变量 VERCEL_OTEL_SOCKET_PATH 已由 Vercel 设置。
守护进程的追踪数据在 Vercel 中如何被查看？
追踪数据会出现在项目的追踪视图中，与项目其他追踪数据一起展示，也可以通过 Vercel CLI 按服务名搜索并以 JSON 格式返回，方便代理或用户检查后台工作进程的操作。
