此页面由 AI 自动翻译。查看英文原版
最后更新

本页目录

  • 收集内容
  • 共享技术元数据
  • DepthAI
  • AI 推理
  • OAK Apps
  • 不收集什么
  • 如何选择退出
Claude CodeCodexCursor
Luxonis 智能体工具包为你常用的编程智能体加载 Luxonis 上下文与技能,更快地基于 OAK 开发应用。
安装工具包

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 CLILUXONIS_TELEMETRY_ENABLED=false
oakctlOAKCTL_ANALYTICS=0
这些设置禁用列出的本地客户端发出的匿名产品遥测。它们不会禁用本地存储的日志、您在错误报告中明确提交的信息,或您有意发送到 Luxonis Hub 以使用云工作流的数据。