Partilhar via

Coleta de telemetria pela CLI do ML.NET

  • Artigo

A ML.NET CLI inclui um recurso de telemetria que coleta dados de uso anônimos que são agregados para uso pela Microsoft.

Como a Microsoft usa os dados

A equipe de produto usa ML.NET dados de telemetria da CLI para ajudar a entender como melhorar as ferramentas. Por exemplo, se os clientes usam com pouca frequência uma tarefa específica de aprendizado de máquina, a equipe de produto investiga por que e usa as descobertas para priorizar o desenvolvimento de recursos. ML.NET telemetria CLI também ajuda na depuração de problemas como falhas e anomalias de código.

Embora a equipe de produto aprecie essa perceção, também sabemos que nem todos querem enviar esses dados. Saiba como desativar a telemetria.

Âmbito

O mlnet comando inicia a CLI ML.NET, mas o comando em si não coleta telemetria.

A telemetria não é habilitada quando você executa o mlnet comando sem nenhum outro comando anexado. Por exemplo:

  • mlnet
  • mlnet --help

A telemetria é habilitada quando você executa um comando ML.NET da CLI, como mlnet classification.

Optar por não participar na recolha de dados

O recurso de telemetria ML.NET CLI está habilitado por padrão.

Desative o recurso de telemetria definindo a MLDOTNET_CLI_TELEMETRY_OPTOUT variável de ambiente como 1 ou true. Essa variável de ambiente se aplica globalmente à ferramenta ML.NET CLI.

Pontos de dados recolhidos

O recurso coleta os seguintes dados:

  • Qual comando foi invocado, como classification
  • Nomes de parâmetros de linha de comando usados (ou seja, "conjunto de dados, label-col, caminho de saída, tempo de trem, verbosidade")
  • Hashed MAC address: um ID criptograficamente (SHA256) anônimo e exclusivo para uma máquina
  • Carimbo de data/hora de uma invocação
  • Três endereços IP octetos (não endereços IP completos) usados apenas para determinar a localização geográfica
  • Nome de todos os argumentos/parâmetros utilizados. Não os valores do cliente, como cadeias de caracteres
  • Nome do arquivo do conjunto de dados Hashed
  • Bucket de tamanho de arquivo do conjunto de dados
  • Sistema operacional e versão
  • Valor dos comandos da tarefa ML: valores categóricos, como regression, classificatione recommendation
  • ML.NET versão CLI (ou seja, 0.3.27703.4)

Os dados são enviados de forma segura para servidores Microsoft usando a tecnologia Azure Application Insights, mantidos sob acesso restrito e usados sob controles de segurança rigorosos de sistemas de Armazenamento do Azure seguros.

Pontos de dados não recolhidos

O recurso de telemetria não coleta:

  • dados pessoais, como nomes de utilizador
  • nomes de arquivos do conjunto de dados
  • dados de arquivos de conjunto de dados

Se você suspeitar que a telemetria ML.NET CLI está coletando dados confidenciais ou que os dados estão sendo manipulados de forma insegura ou inadequada, registre um problema no repositório ML.NET para investigação.

Licença

A distribuição Microsoft de ML.NET CLI é licenciada com os Termos de Licença para Software Microsoft: Microsoft .NET Library. Para obter detalhes sobre a coleta e o processamento de dados, consulte a seção intitulada "Dados".

Divulgação

Quando você executa pela primeira vez um comando ML.NET CLI, como mlnet classification, a ferramenta ML.NET CLI exibe texto de divulgação que informa como desativar a telemetria. O texto pode variar um pouco, dependendo da versão da CLI que você está executando.

Consulte também