Ultralytics Python 包的数据收集#
概述#
Ultralytics 致力于持续提升用户体验和 Python 包的功能，包括我们开发的先进 YOLO 模型。我们会收集匿名使用统计数据和崩溃报告，以帮助发现改进机会并确保软件可靠。本文档将说明我们收集哪些数据、收集目的，以及你对这些数据收集的选择权。
匿名 Google Analytics#
Google Analytics 是 Google 提供的一项网站分析服务，可跟踪并报告网站流量。它使我们能够收集有关 Python 包使用情况的数据，这对于就设计和功能做出明智决策至关重要。
我们收集的数据#
- 使用情况指标：这些指标帮助我们了解软件包的使用频率和方式、用户偏好的功能，以及常用的命令行参数。
- 系统信息：我们会收集有关你计算环境的通用非身份识别信息，以确保我们的软件包在各种系统上都能良好运行。
- 性能数据：了解模型在训练、验证和推理期间的性能，有助于我们发现优化机会。
要详细了解 Google Analytics 和数据隐私，请访问 Google Analytics 隐私。
我们如何使用这些数据#
- 功能改进：使用情况指标带来的洞察有助于我们提升用户满意度并改进界面设计。
- 优化：性能数据有助于我们微调模型，使模型在各种硬件和软件配置下效率更高、速度更快。
- 趋势分析：通过研究使用趋势，我们可以预测并响应社区不断变化的需求。
隐私注意事项#
我们采取了多项措施，确保你托付给我们的数据隐私和安全：
- 匿名化：我们会将 Google Analytics 配置为对收集的数据进行匿名化处理，这意味着不会收集任何个人身份信息（PII）。你可以放心使用我们的服务，个人信息会受到保护。
- 汇总分析：我们仅以汇总形式分析数据。这样可以在不泄露任何个人用户活动的情况下观察规律。
- 不收集图像数据：Ultralytics 不会收集、处理或查看任何训练或推理图像。
Sentry 崩溃报告#
Sentry 是一款面向开发者的错误跟踪软件，可帮助实时发现、诊断和解决问题，确保应用程序稳健可靠。在我们的软件包中，Sentry 通过崩溃报告提供洞察，发挥着关键作用，显著提升了软件的稳定性并助力持续改进。
只有当系统预先安装了 sentry-sdk Python 包时，才会通过 Sentry 启用崩溃报告。此包不包含在 ultralytics 先决条件中，Ultralytics 也不会自动安装它。
我们收集的数据#
只有在已安装 sentry-sdk 包、在设置中启用了 sync=True、通过 pip（而非 git clone）安装了 Ultralytics，并且崩溃发生在 yolo CLI 命令中时，才会发送崩溃报告。崩溃报告可能包含：
- 错误消息和堆栈跟踪：崩溃发生时的异常消息和堆栈跟踪。
- 运行时上下文：Ultralytics 版本、操作系统/环境、安装方式、匿名安装 ID、
yolo可执行文件路径、计算机主机名，以及已安装的 Python 包版本。
要详细了解 Sentry 如何处理数据，请访问 Sentry 隐私政策。
我们如何使用这些数据#
- 调试：分析崩溃日志和错误消息有助于我们快速发现并修复软件错误。
- 稳定性指标：通过持续监控崩溃情况，我们致力于提升软件包的稳定性和可靠性。
隐私注意事项#
- 不包含的数据：报告中不包含局部变量和命令行选项；键盘中断、文件缺失错误和内存不足错误也绝不会上报。不过，错误消息和堆栈跟踪仍可能包含你系统中的文件路径。
- 受控收集：崩溃报告仅限于上述崩溃上下文，并且在
sync=False时会禁用。
停用数据收集#
我们相信应该让用户完全掌控自己的数据。默认情况下，我们的软件包会收集分析数据和崩溃报告，以帮助改善所有用户的体验。不过，我们尊重部分用户可能选择退出此类数据收集。
若要选择不发送分析数据和崩溃报告，只需在 YOLO 设置中设置 sync=False。这样可以确保不会从你的计算机向我们的分析工具传输任何数据。
查看设置#
要了解当前设置的配置，可以直接查看：
你可以使用 Python 查看设置。首先，从 ultralytics 模块导入 settings 对象。使用以下命令打印并返回设置：
from ultralytics import settings
# 查看所有设置
print(settings)
# 返回分析数据和崩溃报告设置
value = settings["sync"]修改设置#
Ultralytics 允许用户轻松修改设置。你可以通过以下方式进行更改：
在 Python 环境中，对 settings 对象调用 update 方法以更改设置：
from ultralytics import settings
# 停用分析数据和崩溃报告
settings.update({"sync": False})
# 将设置重置为默认值
settings.reset()sync=False 设置可阻止向 Google Analytics 或 Sentry 发送任何数据。你的设置将在使用 Ultralytics 软件包的所有会话中生效，并保存到磁盘以供后续会话使用。
对隐私的承诺#
Ultralytics 高度重视用户隐私。我们的数据收集实践遵循以下原则：
- 透明：我们会公开说明收集哪些数据以及如何使用这些数据。
- 控制权：我们让用户完全掌控自己的数据。
- 安全：我们采用符合行业标准的安全措施来保护收集的数据。
问题或疑虑#
如果你对我们的数据收集实践有任何问题或疑虑，请通过联系表单或 support@ultralytics.com 联系我们。我们致力于确保用户在使用我们的软件包时充分了解隐私情况并安心使用。
常见问题#
Ultralytics 通过多项关键措施优先保护用户隐私。首先，通过 Google Analytics 和 Sentry 收集的所有数据都会经过匿名化处理，确保不会收集个人身份信息（PII）。其次，数据会以汇总形式进行分析，让我们能够观察规律，同时不识别个人用户的活动。最后，我们不会收集任何训练或推理图像，进一步保护用户数据。这些措施体现了我们对透明度和隐私保护的承诺。要了解更多详情，请访问隐私注意事项部分。
Ultralytics 使用 Google Analytics 收集三类主要数据：
- 使用情况指标：包括 YOLO Python 包的使用频率和方式、用户偏好的功能以及常用的命令行参数。
- 系统信息：运行该软件包的计算环境的通用非身份识别信息。
- 性能数据：与模型在训练、验证和推理期间的性能相关的指标。
这些数据有助于我们改善用户体验并优化软件性能。要了解更多信息，请参阅匿名 Google Analytics部分。
若要选择退出数据收集，只需在 YOLO 设置中设置
sync=False。这样会停止传输任何分析数据或崩溃报告。你可以通过 Python 或 CLI 停用数据收集：更新设置from ultralytics import settings # 停用分析数据和崩溃报告 settings.update({"sync": False}) # 将设置重置为默认值 settings.reset()要详细了解如何修改设置，请参阅修改设置部分。
如果预先安装了
sentry-sdk包，每当发生崩溃事件时，Sentry 都会收集详细的崩溃日志和错误消息。这些数据有助于我们及时诊断和解决问题，提升 YOLO Python 包的稳健性和可靠性。收集的崩溃日志会清除所有个人身份信息，以保护用户隐私。要了解更多信息，请查看 Sentry 崩溃报告部分。可以，你可以轻松查看当前设置，了解数据收集偏好的配置。请使用以下方法检查这些设置：
查看设置from ultralytics import settings # 查看所有设置 print(settings) # 返回分析数据和崩溃报告设置 value = settings["sync"]如需了解更多详情，请参阅检查设置部分。