Compartilhar via


Coleta de telemetria pela CLI do ML.NET

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

Como a Microsoft usa os dados

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

Embora a equipe de produto aprecia essas informações, ela também sabe que nem todo mundo deseja enviá-las. Saiba como desabilitar a telemetria.

Escopo

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

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

  • mlnet
  • mlnet --help

A telemetria está habilitado quando você executa um comando da CLI do ML.NET, como mlnet classification.

Recusar a coleta de dados

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

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

Pontos de dados coletados

O recurso coleta os seguintes dados:

  • Qual comando foi invocado, como classification
  • Nomes de parâmetros de linha de comando usados (ou seja, "dataset”, “label-col”, “output-path”, “train-time” e “verbosity")
  • Endereço MAC com hash: uma ID única e criptograficamente anônima (SHA256) para um computador
  • Carimbo de data/hora de uma invocação
  • Três endereços IP de octeto (não um endereço IP completo) usados apenas para determinar a localização geográfica
  • Nome de todos os argumentos/parâmetros usados. Não valores do cliente, como cadeias de caracteres
  • Nome do arquivo de conjunto de dados com hash
  • Bucket do tamanho do arquivo de conjunto de dados
  • Sistema operacional e versão
  • Valor dos comandos da tarefa de ML: valores categóricos, como regression, classification e recommendation
  • Versão da CLI do ML.NET (por exemplo, 0.3.27703.4)

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

Pontos de dados não coletados

O recurso de telemetria não coleta:

  • dados pessoais, como nomes de usuário
  • nomes de arquivo de conjunto de dados
  • dados de arquivos de conjunto de dados

Se você suspeita que a telemetria da CLI do ML.NET está coletando dados confidenciais ou que os dados estão sendo manipulados de modo inseguro ou inadequado, registre um problema no repositório ML.NET para investigação.

Licença

A distribuição da Microsoft da CLI do ML.NET é licenciada com os Termos de licença de software da Microsoft: biblioteca .NET da Microsoft. Para obter detalhes sobre a coleta e o processamento de dados, veja a seção intitulada "Dados".

Divulgação

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

Confira também