配置 OpenTelemetry 导出

Enterprise 管理员在 Team Settings > OpenTelemetry Export 配置一个团队管理的目标。导出由 Cursor 服务端执行，发送 token、工具调用和费用 metrics，以及 API、扩展和云端活动 logs。

接收端要求

使用公网可达 HTTPS endpoint，接受 /v1/metrics 和 /v1/logs 的 OTLP/HTTP binary protobuf。当前不支持 gRPC 或 JSON OTLP。设置填写 base URL，例如 https://otel.example.com，不要加 /v1；Cursor 会附加路径。

配置 bearer token 或所需静态 header，并在接收端处理 TLS 与认证。官方源 IP 清单可作为额外 allowlist，但不能代替 TLS/auth。Datadog Agent、OpenTelemetry Collector、ClickHouse/ClickStack 等需先暴露适配的接收端。

启用顺序

Create destination 填 URL/header，Test connection 检查连通性，最后 Enable；通常约一分钟开始。每个 signal/family 可单独关闭，新 family 默认启用，除非关闭 auto_enable_new_families。

conversation_content 是例外，默认关闭，并有团队级与目的地级双重 opt-in，见正文导出。Grok Bot action logs 还需团队 Action Recording，默认关闭，Privacy Mode (Legacy) 强制关闭。

交付与恢复

数据	交付语义
Metrics	at-most-once，失败后 delta 可能有缺口
Logs	at-least-once，按 cursor.event.id 去重
历史数据	创建目标前的数据不回填
关闭/删除目标	丢弃在途数据

轮换凭据应编辑现有目标并保存，约 30 秒生效，不删除重建目标。Headers 加密保存。metric 为 delta，按 series 求和；严格 delta-to-cumulative processor 可能丢弃结束时间逆序的点。

指标与账单

cursor.token.usage 区分 input/output/cache_read/cache_creation，cursor.tool.calls 区分 builtin/MCP，cursor.cost.usage 是 best-effort USD 估算。

cost 同时含套餐用量消耗和 on-demand；BYOK 只反映 Cursor Token Rate，不含 provider 账单。正式费用用用量 API核对。Cursor 不发送 traces，日志没有 trace_id/span_id；会话关联见遥测关联。