# Luxonis 收集哪些遥测数据？

Luxonis 收集选择退出、匿名的产品遥测数据，以了解产品的使用方式以及常见工作流完成的可靠性。聚合的使用和结果数据有助于我们优先改进、集中兼容性测试、检测回归，并识别需要更好可靠性或文档的工作流。

以下类别是遥测规范的高级摘要。它们有意将相关测量分组，而不是列出每个事件属性。

## 收集内容

### 共享技术元数据

所有遥测数据都可能包含发出产品和组件，以及应用程序或 SDK 版本和部署渠道（如果这些值可用）。这些字段有助于识别事件的软件上下文；它们不识别个人、主机或物理设备。

对于 ModelConverter 和 Tools CLI，可选的系统上下文还包括操作系统版本、架构和处理器系列、Python 版本、CPU 计数，以及进程是否在 CI、Docker 或 Luxonis 云基础设施中运行。它不包括主机名、路径和环境变量值。

### DepthAI

 * 管道生命周期和复杂性： 管道是否启动或结束、其持续时间，以及其节点、连接和主机/设备桥的清理摘要。可能包含节点类型和安全属性；自定义节点名称和敏感属性会被编辑。不收集原始管道模式、脚本和模型路径。
 * 粗略运行时上下文： SDK 语言、主机操作系统和版本、应用程序是否作为 OAK App 运行或通过 Python 运行，以及 SDK 库版本。
 * 设备生命周期和连接： SDK 加载、设备连接、定期保持活动、断开连接和连接持续时间；粗略设备型号、平台、传输和速度、独立模式以及设备操作系统版本。短期的随机会话、设备和管道 ID 关联这些事件，而不使用硬件标识符。
 * 设备资源使用： 定期 RVC2 和 RVC4 内存使用、CPU 使用和芯片温度摘要。不收集日志、崩溃转储和原始设备标识符。
 * 管道相机设置： 配置的相机插槽、分辨率、帧速率、帧同步模式以及是否启用 HDR。
 * 模型动物园使用： 是否加载了官方公共模型、其公共模型和团队 slug，以及它是否来自缓存。私有模型和团队 slug 会被编辑。
 * OAK Viewer * 应用程序和后端活动： 应用程序启动模式和生命周期、管道状态转换，以及处理请求的 Viewer 后端端点的受控名称。
    * 配置： 选定的管道预设和神经网络模型、清理后的神经网络和立体深度设置，以及传感器流摘要，例如相机插槽、分辨率以及配置、流式传输或接收的帧速率。
    * 设备健康状况： 聚合设备发现计数；产品型号、连接类型和 USB 代数；支持的设备功能和校准状态；连接带宽；以及断开连接或恢复尝试。
    * 校准： 校准流程是否是首次运行、聚合数据和覆盖进度，以及聚合质量结果，例如 Sampson 误差和角度变化。不收集图像、校准文件和诊断包。
    * 关联： Viewer 流程名称将相关遥测数据分组。当前的 Viewer 实现使用应用程序 ID 作为其分析的唯一标识符；遥测规范禁止添加其他持久标识符。

### AI 推理

 * ModelConverter * 转换设置： 目标平台、配置源和结构、输入模型格式和计数、校准和存档设置、输出/上传选择，以及清理后的特定于目标的选项，例如量化或优化设置。
    * 执行上下文： 转换是否在 Docker 中运行、是否使用开发镜像或 GPU、是否具有自定义镜像或资源限制覆盖，以及解析后的目标工具链版本。
    * 转换结果： 受控的成功、失败或中断状态；持续时间；粗略的失败类别；输出计数和峰值内存桶；以及最终或中间输出是否已上传。不收集模型名称、路径、URL、配置内容、张量名称和异常文本。
 * Tools CLI * YOLO 转换设置： 有效的 YOLO 和导出器系列、版本是提供还是自动检测、目标平台、输入编码和大小、类名覆盖的存在和计数桶，以及远程上传选择。
    * 转换结果： 受控的成功、失败或中断状态；持续时间；粗略的失败类别；ONNX 导出和 NN 存档生成是否成功；以及是否尝试或成功远程上传。不收集模型路径、原始类名、插件名、URL 和异常文本。
    * 关联： 合成的、每次转换的 ID 将配置和结果事件分组，而不识别用户、设备或安装。

### OAK Apps

 * `oakctl` 命令生命周期： 命令何时开始和完成、其规范化的命令路径、存在哪些标志、命令是否有效、粗略的解析错误类别、成功或失败以及执行持续时间。不收集参数值和位置参数。
 * 运行时上下文： 主机操作系统和 CPU 架构，以及在适用时匹配的编码代理环境变量的名称。不收集提示、源代码、工作区内容和环境变量值。
 * 短期关联： 临时的每个进程会话 ID 和短期的关联 ID 可以将附近的 `oakctl` 命令分组，然后在不活动后轮换。包含路径、设备标识符、凭据、令牌或其他敏感值的命令参数会被编辑或排除。

## 不收集什么

遥测仅限于预定义、结构化的字段。Luxonis 遥测不收集：

 * 个人身份信息 (PII)： 姓名、电子邮件地址、用户、团队或帐户 ID，或持久硬件标识符。
 * 凭据： 密码、API 密钥、访问令牌、设备采用密钥、QR 有效负载或环境变量值。
 * 原始媒体或项目数据： 图像、视频、传感器记录、数据集、校准媒体、模型文件或模型内容。
 * 自由格式用户内容： 提示、源代码、脚本、配置内容、命令或参数值、文件名、路径、URL、日志、堆栈跟踪或异常文本。

可以收集从受控目录中选择的公共标识符，例如官方模型动物园 slug。私有名称和其他用户提供的值会被编辑或排除。

## 如何选择退出

在启动产品之前设置适用的环境变量：

| 产品 | 选择退出环境变量设置 |
| --- | --- |
| DepthAI (Python 或 C++) | `DEPTHAI_TELEMETRY=0` |
| ModelConverter 和 Tools CLI | `LUXONIS_TELEMETRY_ENABLED=false` |
| `oakctl` | `OAKCTL_ANALYTICS=0` |

这些设置禁用列出的本地客户端发出的匿名产品遥测。它们不会禁用本地存储的日志、您在错误报告中明确提交的信息，或您有意发送到 Luxonis Hub 以使用云工作流的数据。
