产品使用数据
T3 Code 服务器会把产品使用事件发送到 T3 Code 自己的端点 ingest.t3.codes,并关联一个经过哈希的账户标识或安装标识。为了统计同一个人在使用多少个安装,服务器还会发送经过哈希的账户标识:你的 T3 Connect 账户、你已登录时的 OpenAI 账户和 Claude 账户,以及每一台接入设备的随机标识。该端点会留存每一条事件的副本,并把事件转发到 PostHog。事件包含提供方(provider)、模型、推理强度、权限模式、回合(turn)与请求的结果、耗时、发布通道,以及在有数据时的 token 计数。子智能体的 token 计数与主智能体分开上报。模型名称只有出现在某个提供方的公开模型列表中时才会发送。
产品事件不包含提示词、回复、文件内容、身份验证令牌、对话 ID、原始的提供方事件,以及子智能体的输出。
中继连接诊断
T3 Code 会把中继(relay)连接追踪发送到 Axiom,用来诊断 T3 Connect 的连通性。这些追踪与产品事件是分开的。视客户端(client)版本而定,追踪可以包含连接耗时、环境(environment)标识,以及已连接机器的名称。失败的 span 可以包含错误消息和堆栈跟踪;错误文本里可能会引用应用当时正在处理的某个值。
要在服务器上关闭产品事件和中继追踪,请在启动它之前于其环境中设置 T3CODE_TELEMETRY_ENABLED=false。当 T3CODE_OTEL_SDK_DISABLED 或 OTEL_SDK_DISABLED 关闭 OpenTelemetry 导出时,中继追踪也会停止。
管理员可以用托管策略在服务器和桌面应用里关闭产品事件与中继追踪。这并不能控制由独立的浏览器客户端或移动客户端发出的追踪。
桌面应用在 macOS 和 Linux 上会从 shell 配置文件读取 T3CODE_TELEMETRY_ENABLED(例如 ~/.zshrc),因此请在那里导出它,然后重启应用。在 Windows 上,把它设为用户环境变量。
浏览器里的 Web 应用,包括由 t3 CLI 打开的那个,不会读取这些环境变量。如果它的构建配置了中继追踪,那么即使服务器已经选择退出,它仍会发送自己的连接追踪。浏览器应用没有中继追踪的开关。
移动应用诊断
当 iOS 或 Android 应用崩溃或遇到错误时,它会向 T3 Code 发送一份报告:错误消息、堆栈跟踪、应用版本,以及设备型号和操作系统版本。每次启动还会发送启动耗时,每份报告都带有该次安装的随机 ID。报告经 T3 Connect 中继发往 Axiom。报告不包含你的对话线程(thread)、提示词或连接详情,但错误消息里可能会引用应用当时正在处理的某个值。
要停止发送这些报告,请在 设置 > 关于 T3 Code > 诊断 中关闭 发送崩溃报告。
移动应用在其构建配置了追踪时,也会发送中继连接追踪。这些追踪带有当前应用会话的标识。发送崩溃报告 并不控制这些追踪,移动应用也没有单独的中继追踪开关。服务器的环境变量和托管策略都不会关闭移动端追踪。
供移动通知使用的智能体活动
当某台主机启用 发布智能体活动 时,它会把项目(project)标题和对话线程标题、模型名称、活动状态,以及环境标识和对话线程标识发送到 T3 Connect 中继,供移动通知和实时活动使用。这与产品事件和中继诊断是分开的。退出遥测并不会关闭它。
要停止发布,请在该主机的 设置 > 共享与访问 中关闭 发布智能体活动。在手机上关闭通知,只影响那部手机自己的提醒,不会改变主机上的发布设置。
把诊断数据导出到你自己的接收端
要把追踪、指标或日志发送到 OpenTelemetry 接收端,请打开 设置 > 维护 > 诊断,选择一个环境,并在 OpenTelemetry 导出 下填入每种信号的 OTLP HTTP 端点(例如 http://localhost:4318/v1/traces)。保存之后,重启该环境的服务器。接收端必须能够从服务器所在的机器访问到。 测试 会让服务器发出一次空的导出,以便在保存之前或之后检查某个端点;已保存的端点会在打开这一节时接受检查。检查只会把身份验证请求头发送到该信号当前正在运行的端点,并且不会跟随重定向。要检查一个需要身份验证的新端点,请先保存它并重启服务器。
T3CODE_OTLP_*_URL 以及标准的 OTEL_EXPORTER_OTLP_* 环境变量会覆盖已保存的设置。被覆盖的信号会显示 由环境设置,并写明是哪一个变量设置了它;此时它的 测试 检查的是正在运行的端点,而不是输入框里的值。对于在这里保存的端点,以及用 T3CODE_OTLP_*_URL 设置的端点,需要身份验证的接收端请设置 T3CODE_OTLP_HEADERS,不接受 JSON 的接收端请设置 T3CODE_OTLP_PROTOCOL=http/protobuf。用 OTEL_EXPORTER_OTLP_* 设置的端点,其请求头和协议则改由 OTEL_EXPORTER_OTLP_HEADERS 和 OTEL_EXPORTER_OTLP_PROTOCOL 提供。