Compartilhar via


Coleção de telemetria pela CLI de ML.NET

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

Como a Microsoft usa os dados

A equipe de produtos usa dados de telemetria da CLI do ML.NET para ajudar a entender como melhorar as ferramentas. Por exemplo, se os clientes raramente usam uma tarefa de machine learning específica, a equipe de produtos investiga por que e usa descobertas para priorizar o desenvolvimento de recursos. A telemetria da CLI do ML.NET também ajuda na depuração de problemas, como falhas e anomalias de código.

Embora a equipe de produtos aprecie esse insight, também sabemos que nem todos querem enviar esses dados. Descubra como desabilitar a telemetria.

Escopo

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

A telemetria não está 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 da CLI ML.NET, como mlnet classification.

Recusar a coleta de dados

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

Opte por não usar o recurso de telemetria definindo a variável de MLDOTNET_CLI_TELEMETRY_OPTOUT ambiente como 1 ou true. Essa variável de ambiente se aplica globalmente à ferramenta da CLI 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: um ID exclusivo e anônimo para um dispositivo, gerado criptograficamente (SHA256)
  • Carimbo de data/hora de uma invocação
  • Endereço IP de três octetos (endereço IP não completo) usado apenas para determinar a localização geográfica
  • Nome de todos os argumentos/parâmetros usados. Não os valores do cliente, como cadeias de caracteres
  • Nome do arquivo do conjunto de dados hacheado
  • Bucket do tamanho do arquivo de conjunto de dados
  • Sistema operacional e versão
  • Valor dos comandos de tarefa ML: valores categóricos, como regression, classificatione recommendation
  • ML.NET versão da CLI (ou seja, 0.3.27703.4)

Os dados são enviados com segurança aos servidores Microsoft usando a tecnologia do Azure Application Insights , mantidos sob acesso restrito e usados sob rígidos controles de segurança de sistemas seguros do Armazenamento do Azure .

Pontos de dados não coletados

O recurso de telemetria não coleta:

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

Se você suspeitar que a telemetria da CLI ML.NET 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 da Microsoft de ML.NET CLI é licenciada com os Termos de Licença de Software da Microsoft: Biblioteca do Microsoft .NET. Para obter detalhes sobre coleta e processamento de dados, consulte a seção intitulada "Dados".

Divulgação

Quando você executa pela primeira vez um comando da CLI ML.NET , como mlnet classification, a ferramenta CLI ML.NET exibe o texto de divulgação que informa como recusar a telemetria. O texto pode variar ligeiramente dependendo da versão da CLI em execução.

Consulte também