用量统计、日志与追踪
区分产品统计、自己的遥测后端、API 调试文件和请求关联标识。
Qwen Code 的产品用量统计、用户配置的 telemetry、OpenAI API 调试日志和出站关联标识是不同数据通道,各自有设置。
用量统计
privacy.usageStatisticsEnabled 默认 true。官方说明其向阿里云 RUM 端点发送工具名称/类别/状态/耗时、请求模型/耗时/成功情况,以及会话工具和审批配置;不收集工具参数/返回内容、提示/回答正文、文件内容、姓名、邮件或 API Key。
{
"privacy": {
"usageStatisticsEnabled": false
}
}也可设置 QWEN_USAGE_STATISTICS_ENABLED=false 或 0,环境变量优先,修改后重启。关闭此项不代表其他主动配置的日志也关闭。
自己的 telemetry 后端
telemetry.enabled 控制遥测;otlpEndpoint、otlpProtocol 指定 OTLP 导出。target 的 local/gcp 只是信息标签,不决定路由。outfile 一旦设置,文件输出优先于 OTLP。
logPrompts 控制提示及请求/响应文本日志。includeSensitiveSpanAttributes 默认 false;启用后会把原样用户/系统提示、工具输入输出和模型回答加入原生 OTel span,也可能包含文件与 shell 内容。
sensitiveSpanAttributeMaxLength 默认 1048576,按 JavaScript 字符串长度计,合法整数范围 1–104857600。它不是 UTF-8 字节数。userId 写入 gen_ai.user.id,宜使用假名;共享多用户进程不能用一个全局值冒充每次请求的用户身份。
对应 QWEN_TELEMETRY_ENABLED、TARGET、OTLP_ENDPOINT、OTLP_PROTOCOL、LOG_PROMPTS、USER_ID、INCLUDE_SENSITIVE_SPAN_ATTRIBUTES、SENSITIVE_SPAN_ATTRIBUTE_MAX_LENGTH、OUTFILE 环境变量可覆盖设置。布尔环境项 true/1 启用,其他值关闭;USER_ID 去空白后为空则回到设置值。
API 调试文件
model.enableOpenAILogging 默认 false,启用后将 API 请求响应保存为 JSON。model.openAILoggingDir 未设时是当前目录 logs/openai,支持绝对、相对和 ~ 路径;CLI --openai-logging 与 --openai-logging-dir 可覆盖。
model.openAILogRetentionDays 默认 7,0 为约一小时最短保留。清理后台最多每日完成一轮;短命令尽力处理,长进程可扫描完成。自定义日志目录可能由多个工作区共享,因此保留策略需在用户/系统范围配置,工作区值被跳过。修改需重启。
请求关联数据
outboundCorrelation 两个开关默认 false,与 telemetry 分开授权:
- propagateTraceContext 在出站 fetch 注入 W3C traceparent,并给 shell 子进程 TRACEPARENT;还要求 telemetry.enabled=true。
- allowDynamicHeaderValues 允许 customHeaders 中 ${session_id} 等运行时值。关闭时整个对应 header 被丢弃并警告,不发送原样占位符。
具体收到 header 的主机由 provider baseUrl 和该模型的 customHeaders 决定,不由此开关提供额外主机白名单。扩展后的 session_id 是稳定会话标识,配置前应核对实际端点。
完整导出端点、Resource 与数据字段见OpenTelemetry 配置、指标参考和Trace 关联。