dotnetup telemetry

Note

dotnetup находится в общедоступной предварительной версии. Его функции и поведение могут измениться до момента общей доступности.

dotnetupвключает функцию телеметрии, которая собирает данные об использовании и отправляет его в Microsoft при выполнении dotnetup команд. Данные об использовании содержат сведения об исключении при сбое dotnetup. Команда .NET использует эти данные для того, чтобы понять, как люди используют средство, и устранять проблемы.

Как отказаться

Телеметрия включена по умолчанию. Чтобы отказаться, задайте для переменной среды DOTNET_CLI_TELEMETRY_OPTOUT значение 1 или true.

Это та же переменная, которая отключает телеметрию для пакета SDK .NET и CLI. Дополнительные сведения см. в статье .NET SDK и телеметрия .NET CLI.

Уведомление о первом запуске

При первом запуске dotnetupотображается следующее сообщение:

dotnetup collects usage data to help improve your experience. You can opt out by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1'. Learn more: https://aka.ms/dotnetup-telemetry

Чтобы скрыть это уведомление без отключения телеметрии, задайте переменной среды DOTNET_NOLOGO значение 1 или true.

Точки данных

Функция телеметрии не собирает персональные данные, такие как имена пользователей или адреса электронной почты. Он не сканирует код и не извлекает данные на уровне проекта. dotnetupбезопасно отправляет данные на серверы Microsoft с помощью технологии Azure Monitor.

dotnetup собирает следующие данные:

  • Метка времени вызова.
  • Выполняемая команда, например install, updateили list.
  • dotnetup Версия и SHA коммита.
  • Операционная система и архитектура.
  • Запускается ли dotnetup в среде непрерывной интеграции (CI).
  • Запускается ли dotnetup агентом LLM, например GitHub Copilot.
  • Код выхода или состояние успешного выполнения или сбоя.
  • Для сбоев: тип ошибки, категория ошибки, санированные сведения об ошибке без путей к файлам и трассировка стека без сообщений об исключениях.

Данные телеметрии исключений аварийного сбоя

Если dotnetup аварийно завершается, он собирает имя исключения и трассировку стека кода dotnetup. Это не включает сообщения об исключениях, так как они могут содержать входные данные пользователя. Этот подход совпадает с подходом, который использует пакет SDK .NET. Дополнительные сведения см. в телеметрии аварийных исключений .

Обнаружение агентов CI и LLM

dotnetupиспользует то же обнаружение среды CI и обнаружение агента LLM, что и пакет SDK для .NET. Список проверяемых переменных среды см. в разделах обнаружение непрерывной интеграции и обнаружение LLM.

Variable Description
DOTNET_CLI_TELEMETRY_OPTOUT Отключает телеметрию, если установлено значение true или 1.
DOTNET_NOLOGO Скрывает уведомление о первом запуске при установке 1 или true. Телеметрия остается включенной.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Изменяет каталог, в котором dotnetup локально хранятся данные телеметрии перед отправкой данных.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS В средах CI изменяет максимальное время в миллисекундах, которое dotnetup ожидает перед отправкой данных телеметрии перед выходом. Значение по умолчанию — 20 000.

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

Если вы считаете, что телеметрия собирает конфиденциальные данные или что Microsoft обрабатывает данные небезопасно или неуместным образом, сообщите о проблеме в репозитории dotnet/sdk.

Дополнительные сведения см. в заявлении о конфиденциальности Майкрософт.

См. также

  • Последнее обновление: