telemetria dotnetup

Note

dotnetup está em versão prévia pública. Seus recursos e comportamento podem mudar antes da disponibilidade geral.

dotnetupinclui um recurso de telemetria que coleta dados de uso e os envia para Microsoft quando você executa dotnetup comandos. Os dados de uso incluem informações de exceção quando dotnetup falha. A equipe de .NET usa esses dados para entender como as pessoas usam a ferramenta e corrigir problemas.

Como recusar

A telemetria está ativada por padrão. Para desativar, defina a variável de ambiente DOTNET_CLI_TELEMETRY_OPTOUT como 1 ou true.

Essa é a mesma variável que desativa a telemetria do SDK e da CLI do .NET. Para obter mais informações, consulte telemetria do SDK .NET e da CLI .NET.

Aviso de primeira execução

Na primeira vez que você executar dotnetup, esta mensagem será exibida:

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 esse aviso sem desativar a telemetria, defina a variável de DOTNET_NOLOGO ambiente como 1 ou true.

Pontos de dados

O recurso de telemetria não coleta dados pessoais, como nomes de usuário ou endereços de email. Ele não verifica seu código e não extrai dados no nível do projeto. dotnetupenvia os dados com segurança para servidores Microsoft com tecnologia Azure Monitor.

dotnetup coleta os seguintes dados:

  • O carimbo de data/hora da invocação.
  • O comando que você executa, como install, updateou list.
  • A versão dotnetup e o SHA do commit.
  • O sistema operacional e a arquitetura.
  • Indica se dotnetup é executado em um ambiente de integração contínua (CI).
  • Independentemente de dotnetup ser executado por um agente de LLM, como o GitHub Copilot.
  • O código de saída ou o status de êxito ou falha.
  • Para falhas: o tipo de erro, a categoria de erro, os detalhes de erro higienizados sem caminhos de arquivo e o rastreamento de pilha sem mensagens de exceção.

Telemetria de exceção de falha

Se dotnetup falhar, ele coletará o nome da exceção e o rastreamento de pilha do dotnetup código. Ele não inclui mensagens de exceção, pois elas podem conter a entrada do usuário. Essa abordagem é a mesma que a abordagem que o SDK do .NET usa. Para saber mais, consulte Telemetria de exceção de falha.

Detecção de agente de CI e LLM

dotnetupusa a mesma detecção de ambiente de CI e detecção de agente LLM que o SDK do .NET. Para obter a lista de variáveis de ambiente que ele verifica, consulte Detecção de integração contínua e detecção de LLM.

Variable Descrição
DOTNET_CLI_TELEMETRY_OPTOUT Desativa a telemetria quando definida como 1 ou true.
DOTNET_NOLOGO Oculta o aviso de primeira execução quando definido como 1 ou true. A telemetria permanece ativada.
DOTNET_CLI_TELEMETRY_STORAGE_PATH Altera o diretório em que dotnetup armazena a telemetria 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 aguarda para enviar telemetria antes de sair. O padrão é 20.000.

Privacidade

Se você achar que a telemetria coleta dados confidenciais ou que Microsoft manipula os dados de forma insegura ou inadequada, registre um problema no repositório dotnet/sdk.

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

Consulte também

  • Última atualização em