Skip to content
FunCoding

Search

Search docs, Skills and MCP

用量统计、日志与追踪

区分产品统计、自己的遥测后端、API 调试文件和请求关联标识。

This page has not been translated into English yet. The original Chinese version is shown below.

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 关联。