Telemetria

Esta funcionalidade requer o pacote NuGet Microsoft.Testing.Extensions.Telemetry .

Sugestão

Ao usar o Microsoft.Testing.Platform.MSBuild (incluído de forma transitiva pelos runners MSTest, NUnit e xUnit), esta extensão é registada automaticamente quando instala o pacote NuGet — não são necessárias alterações de código. O registo manual na secção seguinte só é obrigatório se desativar o ponto de entrada gerado automaticamente ao definir <GenerateTestingPlatformEntryPoint>false</GenerateTestingPlatformEntryPoint>.

Registo manual

var builder = await TestApplication.CreateBuilderAsync(args);
builder.AddAppInsightsTelemetryProvider();

Microsoft. Testing.Platform (MTP) recolhe dados de telemetria, que são usados para ajudar a compreender como melhorar o produto. Por exemplo, esses dados de uso ajudam a depurar problemas, como tempos de inicialização lentos, e a priorizar novos recursos. Embora essas informações sejam apreciadas, você pode desativar a telemetria. Para obter mais informações sobre telemetria, consulte declaração de privacidade.

Tipos de dados de telemetria

O MTP apenas recolhe telemetria do tipo Dados de Uso. Os dados de uso são usados para entender como os recursos são consumidos e onde o tempo é gasto ao executar o aplicativo de teste. Isso ajuda a priorizar melhorias no produto.

Desativar relatórios de telemetria

Para desativar a telemetria, defina a variável de ambiente TESTINGPLATFORM_TELEMETRY_OPTOUT ou DOTNET_CLI_TELEMETRY_OPTOUT para 1.

Divulgação

O MTP apresenta texto semelhante ao seguinte quando executa o executável pela primeira vez. O texto de saída pode variar ligeiramente dependendo da versão de MTP que estás a usar. Essa experiência de "primeira execução" é como a Microsoft notifica você sobre a coleta de dados.

Telemetry
---------
Microsoft.Testing.Platform collects usage data in order to help us improve your experience.
The data is collected by Microsoft and are not shared.
You can opt-out of telemetry by setting the TESTINGPLATFORM_TELEMETRY_OPTOUT
or DOTNET_CLI_TELEMETRY_OPTOUT environment variable to '1' or 'true' using your favorite shell.

Read more about Microsoft.Testing.Platform telemetry: https://aka.ms/testingplatform-telemetry

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 analisa o teu código nem extrai dados ao nível do projeto, como repositório, ou autor, extrai o nome do teu executável e envia-o em formato hash.

Não extrai o conteúdo de quaisquer arquivos de dados acessados ou criados pelos seus aplicativos, despejos de memória ocupada pelos objetos dos seus aplicativos ou o conteúdo da área de transferência.

Os dados são enviados de forma segura para servidores Microsoft utilizando a tecnologia Azure Monitor, mantidos sob acesso restrito e publicados sob rigorosos controlos de segurança a partir de sistemas seguros do Armazenamento do Azure.

Proteger a sua privacidade é importante para a Microsoft! Se suspeitar que a telemetria está a recolher dados sensíveis ou que os dados estão a ser tratados de forma insegura ou inadequada, apresente uma questão no repositório microsoft/testfx GitHub ou envie um email para dotnet@microsoft.com para investigação.

O recurso de telemetria coleta os seguintes pontos de dados:

Versão Dados
Tudo Versão do runtime .NET.
Tudo Modo de aplicação, como 'servidor'.
Tudo Contagem de novas tentativas de teste que falharam.
Tudo Contagem de tentativas de teste bem-sucedidas.
Tudo Contagem de testes que falharam.
Tudo Contagem de testes aprovados.
Tudo Contagem de testes que executaram.
Tudo O DisplayName das extensões que você está usando, como um valor hash.
Tudo Se a compilação de depuração da plataforma for usada, então.
Tudo Se o depurador estiver anexado ao processo.
Tudo Caso se tenha utilizado um filtro de testes.
Tudo Se o Hot reload estiver ativado.
Tudo Se o aplicativo falhou.
Tudo Se o aplicativo estiver sendo executado como NativeAOT.
Tudo Se o repositório for o nosso próprio. Com base na configuração telemetry:isDevelopmentRepository em testingplatformconfig.json.
Tudo Nome da estrutura de teste que você está usando, como um valor em hash.
Tudo Nome do seu executável (que normalmente é o mesmo nome do projeto), como valor de hash.
Tudo Sistema operacional, versão e arquitetura.
Tudo Arquitetura de processos.
Tudo Identificador de Tempo de Execução (RID). Para mais informações, consulte .NET RID Catalog.
Tudo O código de saída do aplicativo.
Tudo Três endereços IP de octeto usados para determinar a localização geográfica.
Tudo Carimbo de data/hora da invocação, carimbo de data/hora do início e do fim de várias etapas da execução.
Tudo Versão da plataforma.
Tudo Versão das suas extensões.
Tudo Versão do adaptador de teste.
Tudo Guia para correlacionar eventos de um único corredor.
1.0.3 GUID para correlacionar eventos de uma única execução de testes.

Deteção de integração contínua

Para detetar se a CLI .NET está a correr num ambiente de integração contínua, a CLI .NET sonda a presença e os valores de várias variáveis de ambiente bem conhecidas definidas pelos fornecedores comuns de CI.

A lista completa de variáveis de ambiente, e o que é feito com seus valores, é detalhada na tabela a seguir:

Variável(ões) de ambiente Fornecedor Ação
APPVEYOR Fornecedor Analisar valor booleano.
BUILD_ID, BUILD_URL Jenkins • Verifique se todos estão presentes e não são nulos.
BUILD_ID, PROJECT_ID Google Cloud Build Verifique se todos estão presentes e não são nulos.
CI Muitos/A maioria Analisar valor booleano.
CIRCLECI Círculo CI Analisar valor booleano.
CODEBUILD_BUILD_ID, AWS_REGION Serviço CodeBuild da Amazon Web Services Verifique se todos estão presentes e não são nulos.
GITHUB_ACTIONS GitHub Actions Analisar valor booleano.
JB_SPACE_API_URL Espaço JetBrains Verifique se está presente e se não é nulo.
TEAMCITY_VERSION TeamCity Verifique se está presente e se não é nulo.
TF_BUILD Azure Pipelines Analisar valor booleano.
TRAVIS Travis CI Analisar valor booleano.
  • Last updated on