Телеметрия .NET SDK и .NET CLI

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

Собранные данные публикуются в совокупном виде под лицензией Creative Commons Attribution License. Некоторые собранные данные публикуются на .NET CLI данные телеметрии.

Размах

dotnet имеет две функции: запускать приложения и выполнять команды CLI. Данные телеметрии не собираются при использовании dotnet для запуска приложения в следующем формате:

• dotnet [path-to-app].dll

Данные телеметрии собираются при использовании одной из команд .NET CLI, например:

• dotnet build
• dotnet pack
• dotnet run

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

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

Установщик пакета SDK для .NET отправляет одну запись телеметрии при успешной установке. Чтобы отказаться, задайте переменную среды DOTNET_CLI_TELEMETRY_OPTOUT перед установкой пакета SDK для .NET.

Важный

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

Раскрытие

Пакет SDK для .NET отображает текст, аналогичный следующим выходным данным при первом выполнении одной из команд .NET CLI (например, dotnet build). Текст может немного отличаться в зависимости от версии запущенного пакета SDK. Этот «опыт первого запуска» — способ, которым компания Майкрософт уведомляет вас о сборе данных.

Telemetry
---------
The .NET tools collect usage data in order to help us improve your experience. The data is collected by Microsoft and shared with the community. You can opt-out of telemetry by setting the DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

Read more about .NET CLI Tools telemetry: https://aka.ms/dotnet-cli-telemetry

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

Замечание

Критическое изменение: Поведение телеметрических сообщений, записываемых в stderr, изменилось в последних версиях SDK для .NET. Дополнительные сведения см. в материале команды dotnet CLI фиксируют данные, не относящиеся к команде, в stderr.

Точки данных

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

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

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

На следующих вкладках показаны данные телеметрии, захваченные версией пакета SDK:

.NET 11

• Пакет SDK версии 11.0.100 и более поздних версий:
  • Данные телеметрии кэша выходных данных компилятора Roslyn:
    • Нашёл ли компилятор и восстановил ли кэшированный результат компиляции.
    • Результат попытки сохранить компиляцию в кэше.
    • Язык компилятора (C# или Visual Basic).
    • Время, затраченное на вычисление ключа кэша, восстановление кэшированного результата, сохранение результата, а также компиляцию и генерацию при промахе кэша.

.NET 10

• Пакет SDK версии 10.0.100 и более поздних версий:
  • Хешированный идентификатор проекта для dotnet run.
  • Тип приложения: файловое или проектное для dotnet run.
  • Имя профиля запуска, если он указан для dotnet run.
  • Указан ли профиль запуска для dotnet run.
  • Модель конфигурации параметров запуска, которая используется (если используется) для dotnet run.
  • Количество пакетов SDK, используемых для dotnet run.
  • Количество PackageReferences для dotnet run.
  • Число ссылок ProjectReferences для dotnet run.
  • Количество дополнительных свойств для приложений на основе файлов с dotnet run.
  • Использовался ли MSBuild для файловых приложений.dotnet run
  • Использовался ли компилятор Roslyn для приложений, работающих с файлами с dotnet run.
  • Обнаруженное имя агента LLM, если интерфейс командной строки был вызван агентом LLM. Дополнительные сведения см. в разделе "Обнаружение LLM".
  • global.json Записывает состояние во время вызова команды. Состояние является одним из следующих значений: not_found, valid, invalid_json или invalid_data.
  • Какие фабрики задач MSBuild используются для загрузки и выполнения задач (включая встроенные задачи C#, многопоточные и внепроцессные задачи), а также количество выполняемых ими задач.
  • Количество задач MSBuild, выполняемых в TaskHosts и задачах, не выполняемых в TaskHosts.

.NET 8

• Пакет SDK версии 8.0.400 и более поздних версий:

  • Телеметрия вывода базового образа для контейнерных приложений .NET:
    • Выполнялось ли построение базового образа (в отличие от указания вручную).
    • Целевая платформа для вывода базового образа.
    • Имя и тег базового образа (только для образов, созданных корпорацией Майкрософт, из mcr.microsoft.com).
    • Семейство контейнеров, если задано или выведено (только для образов, созданных корпорацией Майкрософт).
    • Тип проекта (ASP.NET Core или Console).
    • Режим публикации (AOT, Trimmed, Self-Contained или Framework-Dependent).
    • Используется ли инвариантная глобализация.
    • Идентификаторы целевой среды выполнения.
  • Создание контейнера и публикация данных телеметрии:
    • Тип удаленного реестра, используемый для извлечения базовых образов (Azure, AWS, Google, GitHub, Docker Hub, MCR или Other).
    • Тип локального источника, используемого для базовых образов (Docker, Podman или Tarball).
    • Тип удаленного реестра, используемый для отправки образов (Azure, AWS, Google, GitHub, Docker Hub, MCR или Other).
    • Тип локального назначения для изображений (Docker, Podman или Tarball).
    • Типы ошибок при возникновении сбоев (неизвестный репозиторий, сбой учетных данных, несоответствие RID и локальная загрузка).
    • Дополнительные сведения о сбоях учетных данных: произошла ли ошибка во время отправки или загрузки.
    • Дополнительные сведения о несоответствии RID: запрошенный RID и доступные RIDs в базовом образе.

• Пакет SDK версии 8.0.100 и более поздних версий:

  • Hashed TargetPlatformIdentifier, используемый для сборки (свойство MSBuild).
  • Хэшированная HybridGlobalization, используемая для сборки (свойство MSBuild).
  • Используется ли пакет SDK для .NET Blazor WebAssembly.
  • Используется ли пакет SDK для .NET WebAssembly.
  • Используется ли .NET MAUI.
  • Используется ли пакет SDK для .NET для мобильных устройств.
  • Используются ли другие мобильные пакеты SDK (например, Avalonia, Uno).
  • Используется ли Mono AOT.
  • Используется ли функция Mono AOT strip IL.
  • Используется ли интерпретатор Mono.
  • Используется ли режим библиотеки для мобильных устройств.
  • Используется ли NativeAOT.
  • Используемая версия пакета среды выполнения Mono.

.NET 7

• Пакет SDK версии 7.0.100 и более поздних версий:
  • Hashed PublishAot, используемый для сборки (свойство MSBuild).
  • Hashed PublishProtocol, используемый для сборки (свойство MSBuild).

.NET 6

• Пакет SDK версии 6.0.300 и более поздних версий:

  • Если интерфейс командной строки был вызван из среды непрерывной интеграции. Для получения дополнительной информации см. Обнаружение непрерывной интеграции.

• Пакет SDK версии 6.0.104 и более поздних версий:

  • Hashed PublishReadyToRunUseCrossgen2 используется для сборки (свойство MSBuild).
  • Хешированный Crossgen2PackVersion, используемый для сборки (свойство MSBuild).
  • Hashed CompileListCount, используемый для сборки (свойство MSBuild).
  • Хэшированные _ReadyToRunCompilationFailures, используемые для сборки (свойство MSBuild).

• Пакет SDK версии 6.0.100 и более поздних версий:

  • Архитектура ОС.

.NET 5

• Пакет SDK версии 5.0.202 и более поздние версии:

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

• Пакет SDK версии 5.0.201 и более поздних версий:

  • Hashed PublishReadyToRun, используемый для сборки (свойство MSBuild).
  • Hashed PublishTrimmed, используемый для сборки (свойство MSBuild).
  • Hashed PublishSingleFile, используемый для сборки (свойство MSBuild).

• Пакет SDK версии 5.0.100 и более поздних версий:

  • Hashed TargetFrameworkVersion, используемый для сборки (свойство MSBuild).
  • Hashed RuntimeIdentifier, используемый для сборки (свойство MSBuild).
  • Хэшированные selfContained, используемые для сборки (свойство MSBuild).
  • Hashed UseApphost, используемый для компиляции (свойство MSBuild).
  • Хэшированный тип выхода, используемый для сборки (свойство MSBuild).

.NET 3

• Пакет SDK версии 3.0.100 и более поздних версий:
  • Перенаправлены ли выходные данные (true или false).
  • При сбое CLI/SDK тип исключения и его трассировка стека (только код CLI/SDK включен в отправляемую трассировку стека). Дополнительные сведения см. в телеметрии аварийных исключений .

.NET 2

• Пакет SDK версии 2.1.300 и более поздних версий:

  • Версия ядра.
  • Выпуск и версия Libc.

• Пакет SDK версии 2.0 и более поздние версии:

  • Аргументы и параметры команд: пакет SDK собирает несколько аргументов и параметров, а не произвольных строк. См. собранные параметры . Хэширован после версии 2.1.300.
  • Выполняется ли пакет SDK в контейнере.
  • Целевые платформы (из TargetFramework события), хэшированные начиная с версии 2.1.
  • Хэшированные адреса управления доступом к мультимедиа (MAC) (SHA256).
  • Был хэширован текущий рабочий каталог.
  • Отчет об успешной установке с хэшированным именем файла установочного exe.

Все пакеты SDK

• Все версии пакета SDK:
  • Метка времени вызова.
  • Команда, вызываемая (например, "сборка"), хэширована начиная с версии 2.1.
  • Трёхоктетный IP-адрес, используемый для определения географического расположения.
  • Операционная система и версия.
  • Идентификатор среды выполнения (RID), на котором выполняется пакет SDK.
  • Версия пакета SDK для .NET.
  • Профиль телеметрии: необязательное значение, используемое только с явным согласием пользователя и используемым внутри корпорации Майкрософт.

Собранные параметры

Некоторые команды отправляют дополнительные данные. Подмножество команд отправляет первый аргумент:

Команда	Данные первого аргумента, отправленные
dotnet help <arg>	Запрашивается справочная информация по команде.
dotnet new <arg>	Имя шаблона (хэшировано).
dotnet add <arg>	Слово package или reference.
dotnet remove <arg>	Слово package или reference.
dotnet list <arg>	Слово package или reference.
dotnet sln <arg>	Слово add, listили remove.
dotnet nuget <arg>	Слово delete, localsили push.
dotnet workload <subcommand> <arg>	Слово install, update, list, search, uninstall, repair, restore и имя нагрузки в хешированном виде.
dotnet tool <subcommand> <arg>	Слово install, update, list, search, uninstall, run и имя инструмента dotnet (хэшировано).

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

Выбор	Команды
--verbosity	Все команды
--language	dotnet new
--configuration	dotnet build, , dotnet cleandotnet publish, dotnet rundotnet test
--framework	dotnet build dotnet clean, dotnet publish, dotnet run, dotnet test, dotnet vstest
--runtime	dotnet build, dotnet publish
--platform	dotnet vstest
--logger	dotnet vstest
--sdk-package-version	dotnet migrate

Если SDK не может разрешить встроенную команду, любой резолвер команд, который успешно разрешает команду, отправляет хэш имени команды вместе с именем типа резолвера команд.

Начиная с пакета SDK для .NET Core 2.1.100, пакет SDK хэширует все эти значения, кроме --verbosity и --sdk-package-version.

Телеметрия обработчика шаблонов

Начиная с пакета SDK для .NET Core 2.1.100 команда dotnet new создания шаблона собирает дополнительные данные для шаблонов, созданных Корпорацией Майкрософт:

• --framework
• --auth

Dotnet run telemetry

Начиная с .NET SDK 10.0.100, команда dotnet run собирает телеметрию функциональности, чтобы содействовать разработке и использованию приложений, работающих с файлами.

Данные телеметрии для всех dotnet run выполнений:

• Тип приложения (на основе файлов или на основе проекта)
• Хэшируемый проект или идентификатор файла
• Количество используемых пакетов SDK
• Количество PackageReferences
• Число ссылок ProjectReferences
• Использование профиля при запуске (независимо от того, использовался ли --launch-profile или --no-launch-profile)
• Указывает, является ли профиль запуска профилем по умолчанию
• Применена модель параметров запуска( если она есть)

Данные телеметрии только для приложений на основе файлов:

• Количество дополнительных свойств (например, #:property директивы)
• Использовался ли MSBuild для сборки?
• Используется ли компилятор Roslyn напрямую

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

Если интерфейс командной строки или пакет SDK для .NET завершается сбоем, он собирает имя исключения и трассировку стека кода CLI или SDK. Интерфейс командной строки .NET собирает эти сведения для оценки проблем и улучшения качества пакета SDK для .NET и CLI.

Интерфейс командной строки .NET CLI собирает сведения только для исключений CLI или пакета SDK, а не исключений в приложении. Собранные данные содержат имя исключения и трассировку стека. Эта трассировка стека относится к коду CLI или SDK.

В следующем примере показан тип собранных данных:

System.IO.IOException
at System.ConsolePal.WindowsConsoleStream.Write(Byte[] buffer, Int32 offset, Int32 count)
at System.IO.StreamWriter.Flush(Boolean flushStream, Boolean flushEncoder)
at System.IO.StreamWriter.Write(Char[] buffer)
at System.IO.TextWriter.WriteLine()
at System.IO.TextWriter.SyncTextWriter.WriteLine()
at Microsoft.DotNet.Cli.Utils.Reporter.WriteLine()
at Microsoft.DotNet.Tools.Run.RunCommand.EnsureProjectIsBuilt()
at Microsoft.DotNet.Tools.Run.RunCommand.Execute()
at Microsoft.DotNet.Tools.Run.RunCommand.Run(String[] args)
at Microsoft.DotNet.Cli.Program.ProcessArgs(String[] args, ITelemetry telemetryClient)
at Microsoft.DotNet.Cli.Program.Main(String[] args)

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

Из-за этого не следует размещать пользовательские сборки пакета SDK для .NET в каталогах, имена путей которых предоставляют личную или конфиденциальную информацию.

Обнаружение непрерывной интеграции

Чтобы определить, работает ли .NET CLI в среде непрерывной интеграции, интерфейс командной строки .NET проверяет наличие и значения нескольких известных переменных среды, которые задают общие поставщики CI.

В следующем списке показаны переменные среды и использование .NET CLI их значений. Интерфейс командной строки .NET не собирает значение любой переменной среды; Он использует только значение для задания логического флага.

Переменные	Поставщик	Действие
TF_BUILD	Azure Pipelines (система конвейеров Azure)	Разобрать логическое значение
GITHUB_ACTIONS	Действия GitHub	Разобрать логическое значение
APPVEYOR	Appveyor	Разобрать логическое значение
CI	Многие или большинство	Разобрать логическое значение
TRAVIS	Трэвис CI	Разобрать логическое значение
CIRCLECI	CircleCI	Разобрать логическое значение
CODEBUILD_BUILD_ID, AWS_REGION	Amazon Web Services CodeBuild (сервис для автоматизации сборки и тестирования)	Проверьте, что все значения присутствуют и не равны NULL.
BUILD_ID, BUILD_URL	Дженкинс	Проверьте, что все значения присутствуют и не равны NULL.
BUILD_ID, PROJECT_ID	Google Cloud Build	Проверьте, что все значения присутствуют и не равны NULL.
TEAMCITY_VERSION	TeamCity	Проверка наличия и ненулевого значения
JB_SPACE_API_URL	JetBrains Space	Проверка наличия и ненулевого значения

Обнаружение LLM

Чтобы определить, выполняется ли интерфейс командной строки .NET в контексте агента LLM, интерфейс командной строки .NET проверяет наличие и значения нескольких переменных среды, заданных агентами LLM и помощниками по программированию ИИ.

В следующей таблице показаны имя агента, переменная среды, используемая для обнаружения, и значение указанного типа агента. Фактические значения этих переменных среды не собираются— они используются только для идентификации типа агента.

Агент LLM	Variable	Ценность
GitHub Copilot	GITHUB_COPILOT_CLI_MODE	Копилот-система
Код Клода	CLAUDECODE	Клод
Cursor	CURSOR_EDITOR	курсор
Google Gemini	GEMINI_CLI	"близнецы"

Если интерфейс командной строки .NET обнаруживает несколько агентов, он объединяет различные значения агента с запятой для создания окончательного значения.

См. также

• данные телеметрии .NET CLI
• справочный источник телеметрии (репозиторий dotnet/sdk)