Compartilhar via


Microsoft.VisualStudio.Telemetry Namespace

Classes

AssetEvent

Uma classe que armazena informações para o evento de ativo. O ativo é o destino da tarefa ou operação do usuário, por exemplo, Solução, Projeto, Arquivo, Extensão, Licença Designer.

AssetService

Uma classe para fornecer métodos de ajuda para o consumidor de ativos e provedores. Os consumidores podem usar essa classe para obter correlação por meio do método GetCorrelation. Os provedores podem registrar correlação existente nesse serviço por meio do método RegisterCorrelation ou(e) registrar-se por meio do método RegisterProvider para enviar eventos de ativo e retornar correlação por solicitação dos consumidores.

DataModelEventNameHelper

Uma classe auxiliar para validar se o nome do evento está em conformidade com o esquema de nome do evento do modelo de dados e definir propriedades com base no nome. Aqui está o esquema de nome do evento do modelo de dados, ele requer que o nome do evento seja uma cadeia de caracteres exclusiva, não nula ou vazia. Ele consiste em três partes e deve seguir o padrão [product]/[featureName]/[entityName]. FeatureName pode ser um recurso de um nível ou uma hierarquia de recursos delimitada por "/". Para obter exemplos, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

FaultEvent

Um evento de telemetria que representa uma Falha, como uma exceção Temos dois back-ends para enviar dados: o back-end de Telemetria e o Watson (back-end). Multiplataforma , (como no Mac, Linux), podemos usar a mesma arquitetura. Por exemplo, no Mac, há o Merp, a implementação máxima de Relatório de Erros do Windows. FaultEvent herda de TelemetryEvent User pode criar uma instância dessa classe diretamente e pode adicionar propriedades personalizadas diretamente na classe sem usar a chamada de volta. Depois de criar um desses, chame Session.PostFault(faultEvent) que chamará o retorno de chamada, poste o evento para Watson (se amostrado) e Postar como um evento de telemetria normal Ou você pode usar TelemetrySession.PostFault() em vez dessa classe diretamente.

JsonCreationConverter<T>

Classe base abstrata, serve como uma classe base para os criadores de objeto durante desserializar objetos do Json usando Newtonsoft.Json

OperationEvent

Uma classe que armazena informações para o evento de modelo de dados de operação. Uma operação executa algum trabalho no aplicativo e vem com o resultado (por exemplo, Êxito, Falha). Se a operação for invocada diretamente pelo usuário, use UserTaskEvent ou métodos relacionados. Alguns exemplos de operações são, marcar de licença, carregamento de pacote, carregamento de layout do Windows.

Para uma operação assíncrona ou de execução prolongada, para entender o que mais aconteceu durante o tempo ou acompanhar se ela for parcialmente concluída devido a um erro, use o método StartOperation(TelemetrySession, String) que controla os pontos de início e de término.

TelemetryActivity

[OBSOLETO] Use o modelo TelemetryScope<T> de dados para acompanhar o desempenho em versões de desenvolvimento15 e superiores. Mais detalhes estão em http://aka.ms/datamodel.

TelemetryComplexProperty

Essa classe representa um suporte de valor complexo, como matrizes, dicionários. O processador o converterá na cadeia de caracteres JSON. Também para esses tipos, relaxamos as restrições do 1K para o valor da propriedade.

TelemetryContext

O Contexto de Telemetria é um conceito de uma unidade de trabalho. Mais detalhes aqui

TelemetryDataModelProperty

Essa classe representa uma propriedade de modelo de dados.

TelemetryDisposableObject

Classe base auxiliar para fornecer método virtual para liberar recursos gerenciados e impedir de chamar Dispose várias vezes.

TelemetryEvent

A classe representa um evento de telemetria que pode ser postado em um servidor. A classe NÃO é thread-safe

TelemetryEventMatchByName

Essa classe é usada para representar um filtro de telemetria pelo nome do evento de telemetria.

TelemetryHashedProperty

Essa classe representa uma propriedade que deve ser hashed. Durante o processamento, o valor bruto contido será transformado em um valor hash por um algoritmo de criptografia.

TelemetryMetricProperty

Essa classe representa uma propriedade de métrica do modelo de dados. O nome da propriedade será atualizado com um sufixo ". DataModelMetric" quando o evento é postado. Uma métrica é um valor ou uma contagem agregada coletada como uma medida de uma característica específica do sistema. Por exemplo, métricas de uso como tamanho do arquivo, contagem de projetos, tamanho do upload; métrica de desempenho como duração.

TelemetryPiiProperty

Essa classe representa uma propriedade de informações de identificação pessoal. Durante o processamento, o valor bruto contido será transformado em um valor hash por um algoritmo de criptografia.

TelemetryPropertyBag

TelemetryPropertyBag destina-se à adição de propriedades aos eventos de subscibed

TelemetryPropertyBags

Coleções dos sacos de propriedades

TelemetryPropertyBags.Concurrent<TValue>

Recipiente de propriedades simultâneas

TelemetryResultStrings

Uma classe que define as cadeias de caracteres usadas para a propriedade Result.

TelemetryScope<T>

Essa classe é usada para enviar eventos de modelo de dados para um trabalho de aplicativo com duração e resultado. O evento pode ser UserTaskEvent ou OperationEvent ele envia um evento no início e o outro no final do trabalho.

TelemetryScopeSettings

Essa classe é para encapsular as configurações usadas para controlar o comportamento de TelemetryScope ao criar uma instância dela.

TelemetryService

Classe De telemetria principal. Ele tem o objeto de sessão padrão.

TelemetrySession

Representa uma sessão de telemetria que pode postar eventos de telemetria e propriedades de sessão. A API faz o melhor esforço para fornecer dados de telemetria ao servidor. As solicitações são enfileiradas e enviadas em lotes. Os eventos serão salvos localmente se não puderem ser enviados antes da saída do processo. O envio será retomado quando a próxima instância do aplicativo chamar a API de telemetria. A telemetria pode ser perdida em caso de falta de resposta do processo ou falha fatal ou nenhuma conexão com a Internet por 30 dias. Todos os métodos são thread-safe e retornam imediatamente.

TelemetrySessionCommandLineExtensions

Métodos de extensão para TelemetrySession postar argumentos de linha de comando.

TelemetrySessionExtensions

Uma classe para conter todos os métodos de extensão de modelo de dados para a classe TelemetrySession existente.

TelemetrySettingProperty

Essa classe representa uma propriedade de configuração de modelo de dados. O nome da propriedade será atualizado com um sufixo ". DataModelSetting" quando o evento é postado. Uma configuração é algo que o usuário pode personalizar o valor para alterar a aparência/sensação/comportamento do aplicativo. Por exemplo, todas as configurações na caixa de diálogo de opções de ferramentas vs. Propriedades ambientais ou de nível de máquina não são configurações. Eles devem ser postados como propriedades regulares. Por exemplo, contagem de CPU, localidade do sistema operacional.

TelemetryTestChannelEventArgs

Argumentos de canal de teste

UserTaskEvent

Uma classe que armazena informações para o evento de modelo de dados de tarefa do usuário. Uma tarefa de usuário é uma operação de aplicativo que é INVOCADA PELO USUÁRIO diretamente e vem com resultado (por exemplo, Êxito, Falha). Ele é usado para análise de comportamento/intenção do usuário. O usuário está ciente da operação e pode executar. Por exemplo, Abrir projeto e Mostrar janelas de ferramentas são tarefas do usuário; Em vez disso, carregue o pacote VS e o build de tempo de design são operações.

Para uma tarefa de usuário de longa duração ou assíncrona, a fim de entender o que mais aconteceu durante o tempo ou acompanhar se ela for parcialmente concluída devido a um erro, use o método StartUserTask(TelemetrySession, String) que controla os pontos de início e de término.

Estruturas

TelemetryEventCorrelation

Um struct para definir informações de correlação.

Interfaces

IAssetProvider

Uma interface implementada pelo provedor de ativos para oferecer id de correlação de ativo sob demanda.

IFaultUtility

Interface para FaultCallback usada para chamadores de código nativos também

ISetTelemetrySession

TelemetryNotificationService.Default e TelemetryService.DefaultSession

ITelemetryEtwProvider

Implementação do provedor ETW específico do host para eventos de telemetria.

ITelemetryEventMatch

Representa um filtro de evento de telemetria.

ITelemetryManifestRouteArgs

Interface ITelemetryManifestRouteArgs para fornecer argumentos ao roteador

ITelemetryPropertyBag<TValue>

Interface ITelemetryPropertyBag para o PropertyBag genérico

ITelemetryTestChannel

Interface dos canais de teste para receber eventos

Enumerações

DataModelEventType

Tipo de evento modelo de dados com suporte

FaultSeverity

Um indicador da gravidade de uma determinada falha com base na importância ou no impacto previstos. Falhas mais graves serão promovidas mais altas em relatórios, e falhas menos graves serão enfatizadas.

OperationStageType

Uma enumeração para definir o tipo de estágio de operação. Não altere o nome da enumeração porque ele faz parte do contrato cliente-servidor.

TelemetryResult

Uma enumeração para definir o resultado da tarefa ou operação do usuário.

TelemetrySeverity

Uma enumeração para definir a gravidade do evento de telemetria. Ele é usado para qualquer consumidor de dados que queira categorizar dados com base na gravidade.

WER_DUMP_TYPE

Tipo de despejo https://msdn.microsoft.com/en-us/library/windows/desktop/bb513622(v=vs.85).aspx