dotnetup telemetry

Note

dotnetup está em versão preliminar pública. As suas funcionalidades e comportamento podem mudar antes da disponibilidade geral.

dotnetup inclui uma funcionalidade de telemetria que recolhe dados de utilização e os envia para a Microsoft quando executa comandos dotnetup. Os dados de utilização incluem informação de exceção quando dotnetup falha. A equipa do .NET utiliza estes dados para perceber como as pessoas utilizam a ferramenta e para resolver problemas.

Como optar por não participar

Telemetria está ativada por padrão. Para optar por sair, defina a DOTNET_CLI_TELEMETRY_OPTOUT variável de ambiente para 1 ou true.

Esta é a mesma variável que desliga a telemetria para o SDK .NET e CLI. Para mais informações, consulte telemetria do SDK do .NET e da CLI do .NET.

Aviso da primeira execução

Na primeira vez que executas dotnetup, é apresentada esta mensagem:

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

Para ocultar este aviso sem desligar a telemetria, defina a DOTNET_NOLOGO variável de ambiente para 1 ou true.

Pontos de dados

O recurso de telemetria não coleta dados pessoais, como nomes de usuário ou endereços de e-mail. Não digitaliza o seu código, nem extrai dados ao nível do projeto. dotnetupenvia os dados de forma segura para servidores da Microsoft com tecnologia Azure Monitor.

dotnetup recolhe os seguintes dados:

  • O carimbo temporal da invocação.
  • O comando que executa, como install, update ou list.
  • A versão dotnetup e commit SHA.
  • O sistema operativo e a arquitetura.
  • Se o dotnetup é executado num ambiente de integração contínua (CI).
  • Se dotnetup corre a partir de um agente LLM, como o GitHub Copilot.
  • O código de saída, ou o estado de sucesso ou fracasso.
  • Para falhas: o tipo de erro, a categoria de erro, detalhes de erro sanitizados sem caminhos de ficheiro, e o rastreio da pilha sem mensagens de exceção.

Telemetria de exceção de falha

Se dotnetup falhar, recolhe o nome da exceção e o rasto de pilha do dotnetup código. Não inclui mensagens de exceção, porque podem conter entrada do utilizador. Esta abordagem é igual à que o SDK .NET utiliza. Para obter mais informações, consulte Telemetria de exceção de falha.

Deteção de agentes CI e LLM

dotnetuputiliza a mesma deteção de ambiente CI e deteção de agentes LLM que o SDK .NET. Para a lista de variáveis de ambiente que verifica, veja Deteção de integração contínua e deteção de LLM.

Variable Description
DOTNET_CLI_TELEMETRY_OPTOUT Desliga a telemetria quando definido para 1 ou true.
DOTNET_NOLOGO Oculta o aviso de primeira execução quando definido para 1 ou true. A telemetria mantém-se ativa.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Altera o diretório onde a telemetria é armazenada por dotnetup localmente antes de enviar os dados.
DOTNET_CLI_TELEMETRY_SHUTDOWN_TIMEOUT_MS Em ambientes de CI, altera o tempo máximo, em milissegundos, que dotnetup espera para enviar telemetria antes de este terminar. O valor predefinido é 20.000.

Privacidade

Se acha que a telemetria recolhe dados sensíveis, ou que a Microsoft lida com os dados de forma insegura ou inadequada, abra uma issue no repositório dotnet/sdk.

Para obter mais informações, consulte a Declaração de Privacidade da Microsoft.

Ver também

  • Última atualização a