Анонимная аналитика

Homebrew собирает анонимную аналитику с помощью InfluxDB. При первом запуске brew update или установке Homebrew вы получите уведомление. Аналитика не включается до показа этого уведомления, чтобы вы могли отказаться от участия, не отправив ни одного аналитического данных.

Зачем?

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

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

Как долго?

Срок хранения анонимной аналитики Homebrew в InfluxDB составляет 365 дней.

Какие данные?

Аналитика Homebrew записывает некоторые общие сведения для каждого события, связанного с формулой или каском:

• Отправляются ли данные из CI, например true, если задана переменная среды CI.
• Используете ли вы префикс установки по умолчанию (например, /opt/homebrew) или пользовательский (например, /home/mike/.brew). Если ваш префикс является пользовательским, он будет отправлен как custom-prefix для сохранения анонимности.
• Являетесь ли вы разработчиком Homebrew, например true, если задана переменная среды HOMEBREW_DEVELOPER.
• Задана ли переменная devcmdrun, например true, если вы когда-либо запускали одну из команд Homebrew для разработчиков.
• Архитектура вашего процессора, например x86_64.
• Используемая вами ОС и её версия, например macOS 13.
• Версия Homebrew, например 4.0.0.

Все аналитические данные, ранее отправленные в Google Analytics, уничтожены.

Аналитика Homebrew записывает следующие типы событий:

• Категорию события install и формулу Homebrew из неперсонального GitHub tap, которую вы устанавливаете, а также использованные параметры (например, wget --HEAD) в качестве действия. Это позволяет определить, для каких формул следует расставить приоритеты в работе, а также как поступить в случае возможного объявления формулы устаревшей или её удаления.
• Категорию события install_on_request и формулу Homebrew из неперсонального GitHub tap, которую вы запросили установить (например, если она явно указана с помощью brew install), а также параметры. Это позволяет отличать формулы, которые пользователи намерены установить, от формул, подключаемых как зависимости.
• Категорию события cask_install и каск Homebrew из неперсонального GitHub tap, который вы устанавливаете, в качестве действия. Это позволяет определить, для каких касков следует расставить приоритеты в работе, а также как поступить в случае возможного объявления каска устаревшим или его удаления.
• Категорию события build_error и формулу Homebrew с параметрами, установку которой не удалось выполнить, в качестве действия, например wget --HEAD. Это позволяет выявлять формулы, которые, возможно, требуют исправления. Подробности или журналы ошибок сборки не отправляются.
• Категорию события command_run и выполненную команду с флагами в качестве действия. Это позволяет определить, какие команды и флаги используются чаще всего, а какие не используются вовсе.
• Категория события test_bot_test используется только в среде CI Homebrew для записи результатов выполнения тестов для запросов на включение изменений.

Вы также можете посмотреть все сведения, отправляемые аналитикой Homebrew, задав в своей среде HOMEBREW_ANALYTICS_DEBUG=1. Обратите внимание: это также остановит отправку любых аналитических данных.

Разработчики Homebrew не могут сопоставить какое-либо конкретное событие с конкретным пользователем. Мы не храним IP-адреса и не получаем их.

Когда и куда?

Аналитические данные Homebrew отправляются в InfluxDB по HTTPS во время работы Homebrew.

Кто?

Сводные данные аналитических событий доступны всем. Также доступен JSON API. Большинству сопровождающих Homebrew не предоставляется доступ к более подробным аналитическим данным помимо этих общедоступных ресурсов.

Как?

Исходный код доступен в analytics.rb и analytics.sh. Аналитика запускается в отдельном фоновом процессе и быстро завершается при ошибке, чтобы не задерживать выполнение. При отсутствии подключения к сети она немедленно и без каких-либо сообщений завершится с ошибкой.

Отказ от участия

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

export HOMEBREW_NO_ANALYTICS=1

Также можно полностью запретить отправку аналитических данных:

brew analytics off