Начать

Сбор данных пакетом Ultralytics для Python

Обзор#

Ultralytics постоянно улучшает пользовательский опыт и возможности нашего пакета Python, в том числе разрабатываемых нами моделей YOLO. Для этого мы собираем анонимизированную статистику использования и отчёты о сбоях, которые помогают находить возможности для улучшения и обеспечивать надёжность ПО. В этом документе о прозрачности описано, какие данные мы собираем и зачем, а также какие у тебя есть варианты в отношении сбора данных.

Анонимизированная Google Analytics#

Google Analytics — это сервис веб-аналитики от Google, который отслеживает посещаемость сайтов и формирует отчёты. Он позволяет нам собирать данные об использовании нашего пакета для Python, что крайне важно для принятия обоснованных решений о дизайне и функциональности.

Какие данные мы собираем#

  • Показатели использования: помогают понять, как часто и каким образом используется пакет, какие функции предпочитают пользователи и какие аргументы командной строки обычно применяются.
  • Информация о системе: мы собираем общие обезличенные сведения о вычислительной среде, чтобы обеспечить корректную работу пакета на различных системах.
  • Данные о производительности: сведения о производительности наших моделей при обучении, валидации и инференсе помогают находить возможности для оптимизации.

Дополнительную информацию о Google Analytics и конфиденциальности данных смотри в разделе Конфиденциальность в Google Analytics.

Как мы используем эти данные#

  • Улучшение функций: сведения о показателях использования помогают нам повышать удовлетворённость пользователей и улучшать дизайн интерфейса.
  • Оптимизация: данные о производительности помогают настраивать модели для повышения эффективности и скорости работы на различных конфигурациях оборудования и программного обеспечения.
  • Анализ тенденций: изучая тенденции использования, мы можем предвидеть меняющиеся потребности нашего сообщества и реагировать на них.

Конфиденциальность#

Мы принимаем ряд мер для обеспечения конфиденциальности и безопасности данных, которые ты нам доверяешь:

  • Анонимизация: мы настроили Google Analytics так, чтобы собранные данные анонимизировались; это означает, что персональные данные, позволяющие установить личность (PII), не собираются. Ты можешь пользоваться нашими сервисами, будучи уверенным, что твои личные данные останутся конфиденциальными.
  • Агрегирование: данные анализируются только в агрегированном виде. Это позволяет выявлять закономерности, не раскрывая действия отдельных пользователей.
  • Изображения не собираются: Ultralytics не собирает, не обрабатывает и не просматривает изображения для обучения или инференса.

Отчёты о сбоях через Sentry#

Sentry — это сервис отслеживания ошибок, который помогает разработчикам выявлять, диагностировать и устранять проблемы в реальном времени. В нашем пакете отчёты о сбоях из Sentry помогают повышать стабильность ПО.

Примечание

Отправка отчётов о сбоях через Sentry включается, только если пакет Python sentry-sdk предварительно установлен в твоей системе. Этот пакет не входит в список предварительных требований ultralytics и не устанавливается автоматически Ultralytics.

Какие данные мы собираем#

Отчёты о сбоях отправляются, только если пакет sentry-sdk уже установлен, в настройках задано sync=True, Ultralytics установлен через pip (а не клонированием git-репозитория) и сбой произошёл при выполнении команды CLI yolo. Отчёт о сбое может содержать:

  • Сообщения об ошибках и трассировки стека: сообщение исключения и трассировку стека на момент сбоя.
  • Контекст выполнения: версия Ultralytics, операционная система и среда, способ установки, анонимизированный идентификатор установки, путь к исполняемому файлу yolo, имя хоста компьютера и версии установленных пакетов Python.

Подробнее о том, как Sentry обрабатывает данные, читай в Политике конфиденциальности Sentry.

Как мы используем эти данные#

  • Отладка: анализ журналов сбоев и сообщений об ошибках помогает нам быстро выявлять и исправлять ошибки программного обеспечения.
  • Показатели стабильности: постоянно отслеживая сбои, мы стремимся повышать стабильность и надёжность нашего пакета.

Конфиденциальность#

  • Данные, которые не собираются: локальные переменные и параметры командной строки не включаются в отчёты; прерывания с клавиатуры, ошибки отсутствующих файлов и ошибки нехватки памяти никогда не отправляются. Однако сообщения об ошибках и трассировки стека могут содержать пути к файлам из твоей системы.
  • Ограниченный сбор данных: отчёты о сбоях содержат только описанный выше контекст сбоя, а сбор отключается в любом случае, когда sync=False.

Отключение сбора данных#

Мы считаем, что пользователи должны полностью контролировать свои данные. По умолчанию наш пакет настроен на сбор аналитических данных и отчётов о сбоях, чтобы улучшать работу для всех пользователей. Однако мы понимаем, что некоторые пользователи могут отказаться от такого сбора данных.

Чтобы отказаться от отправки аналитических данных и отчётов о сбоях, достаточно задать sync=False в настройках YOLO. Это гарантирует, что данные с твоего компьютера не будут передаваться нашим инструментам аналитики.

Просмотр настроек#

Ты можешь посмотреть текущие настройки напрямую:

Просмотр настроек

Ты можешь просмотреть настройки с помощью Python. Для этого импортируй объект settings из модуля ultralytics. Выведи настройки и верни их с помощью следующих команд:

from ultralytics import settings

# Просмотр всех настроек
print(settings)

# Возврат значения настройки аналитики и отчётов о сбоях
value = settings["sync"]

Изменение настроек#

Ultralytics позволяет легко изменять настройки. Это можно сделать следующими способами:

Обновление настроек

В среде Python вызови метод update для объекта settings, чтобы изменить настройки:

from ultralytics import settings

# Отключение аналитики и отчётов о сбоях
settings.update({"sync": False})

# Сбросить настройки до значений по умолчанию
settings.reset()

Настройка sync=False предотвращает отправку данных в Google Analytics или Sentry. Настройки будут применяться во всех сеансах работы с пакетом Ultralytics и сохранятся на диске для последующих сеансов.

Приверженность конфиденциальности#

Ultralytics серьёзно относится к конфиденциальности пользователей. При разработке практик сбора данных мы руководствуемся следующими принципами:

  • Прозрачность: мы открыто рассказываем о том, какие данные собираем и как их используем.
  • Контроль: мы предоставляем пользователям полный контроль над их данными.
  • Безопасность: мы применяем стандартные для отрасли меры безопасности, чтобы защитить собираемые данные.

Вопросы и замечания#

Если у тебя есть вопросы или замечания о наших практиках сбора данных, свяжись с нами через форму обратной связи или support@ultralytics.com. Мы стремимся к тому, чтобы пользователи чувствовали себя информированными и уверенными в защите конфиденциальности при работе с нашим пакетом.

Часто задаваемые вопросы#

  • Ultralytics заботится о конфиденциальности пользователей и применяет ряд ключевых мер. Во-первых, данные, собранные через Google Analytics, анонимизируются, поэтому мы не собираем персональные данные (PII); в отчёты о сбоях Sentry не попадают локальные переменные и параметры командной строки. Во-вторых, данные анализируются в обобщённом виде: так мы можем наблюдать закономерности, не определяя действия отдельных пользователей. Наконец, мы не собираем изображения для обучения или инференса, что обеспечивает дополнительную защиту данных пользователей. Эти меры соответствуют нашему стремлению к прозрачности и соблюдению конфиденциальности.

  • С помощью Google Analytics Ultralytics собирает три основных типа данных:

    • Показатели использования: сюда входят сведения о том, как часто и каким образом используется пакет YOLO для Python, какие функции предпочитают пользователи и какие аргументы командной строки обычно применяются.
    • Информация о системе: общие обезличенные сведения о вычислительных средах, в которых запускается пакет.
    • Данные о производительности: показатели производительности моделей при обучении, валидации и инференсе.

    Эти данные помогают нам улучшать взаимодействие с пользователями и оптимизировать производительность программного обеспечения. Подробнее читай в разделе Анонимизированная Google Analytics.

  • Чтобы отказаться от сбора данных, достаточно задать sync=False в настройках YOLO. Это прекращает отправку аналитических данных и отчётов о сбоях. Отключить сбор данных можно с помощью Python или CLI:

    Обновление настроек
    from ultralytics import settings
    
    # Отключение аналитики и отчётов о сбоях
    settings.update({"sync": False})
    
    # Сбросить настройки до значений по умолчанию
    settings.reset()

    Подробнее об изменении настроек читай в разделе Изменение настроек.

  • Если пакет sentry-sdk установлен заранее, Sentry собирает подробные журналы сбоев и сообщения об ошибках при каждом сбое. Эти данные помогают нам оперативно диагностировать и устранять проблемы, повышая надёжность и устойчивость пакета YOLO Python. Отчёты о сбоях не содержат локальных переменных и параметров командной строки, однако сообщения об ошибках и трассировки стека могут включать пути к файлам, а контекст выполнения — имя хоста компьютера; если тебя это беспокоит, установи sync=False.

  • Да, ты можешь легко посмотреть текущие настройки и узнать, как сконфигурированы параметры сбора данных. Используй следующие способы, чтобы проверить эти настройки:

    Просмотр настроек
    from ultralytics import settings
    
    # Просмотр всех настроек
    print(settings)
    
    # Возврат значения настройки аналитики и отчётов о сбоях
    value = settings["sync"]

    Подробнее см. раздел Проверка настроек.

Комментарии

Задай вопрос, поделись результатами или помоги кому-нибудь.