Microsoft.VisualStudio.Telemetry Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 |