Partager via


Microsoft.VisualStudio.Telemetry Espace de noms

Classes

AssetEvent

Classe qui stocke des informations pour l’événement de ressource. La ressource est la cible d’une tâche ou d’une opération de l’utilisateur, par exemple Solution, Projet, Fichier, Extension, Licence, Designer.

AssetService

Classe permettant de fournir des méthodes d’aide pour le consommateur et les fournisseurs de ressources. Les consommateurs peuvent utiliser cette classe pour obtenir une corrélation via la méthode GetCorrelation. Les fournisseurs peuvent inscrire la corrélation existante dans ce service via la méthode RegisterCorrelation, ou(et) s’inscrire eux-mêmes via la méthode RegisterProvider pour envoyer des événements de ressource et retourner la corrélation par demande des consommateurs.

DataModelEventNameHelper

Classe d’assistance pour vérifier si le nom de l’événement est conforme au schéma de nom d’événement du modèle de données et définir les propriétés en fonction du nom. Voici le schéma de nom d’événement du modèle de données. Il nécessite que le nom d’événement soit une chaîne unique, et non null ou vide. Il se compose de 3 parties et doit suivre le modèle [product]/[featureName]/[entityName]. FeatureName peut être une fonctionnalité ou une hiérarchie de caractéristiques à un niveau délimitée par « / ». Pour obtenir des exemples, vs/platform/opensolution ; vs/platform/editor/lightbulb/fixerror ;

FaultEvent

Événement de télémétrie représentant une erreur, telle qu’une exception Nous avons 2 back-ends pour envoyer des données : le serveur principal de télémétrie et le serveur principal Watson (back-end). Multiplateforme (comme sur Mac, Linux), nous pouvons utiliser la même architecture. Par exemple, sur Mac, il existe Merp, l’implémentation Max de Rapport d'erreurs Windows. FaultEvent hérite de TelemetryEvent L’utilisateur peut créer directement un instance de cette classe et ajouter des propriétés personnalisées directement sur la classe sans utiliser de rappel. Après avoir créé l’un de ces éléments, appelez Session.PostFault(faultEvent) qui appellera le rappel, publiera l’événement sur Watson (s’il est échantillonné) et Publier en tant qu’événement de télémétrie normal. Vous pouvez utiliser TelemetrySession.PostFault() directement au lieu de cette classe.

JsonCreationConverter<T>

Classe de base abstraite, sert de classe de base pour les créateurs d’objets lors de la désérialisation d’objets à partir du json à l’aide de Newtonsoft.Json

OperationEvent

Classe qui stocke des informations pour l’événement de modèle de données d’opération. Une opération effectue un certain travail dans l’application et est fournie avec un résultat (par exemple, Réussite, Échec). Si l’opération est appelée directement par l’utilisateur, utilisez UserTaskEvent ou les méthodes associées. Voici quelques exemples d’opérations : case activée de licence, chargement de package, chargement de la disposition des fenêtres.

Pour les opérations asynchrones ou d’exécution de longue durée, pour comprendre ce qui s’est passé pendant le temps ou suivre si elle se termine partiellement en raison d’une erreur, utilisez la méthode StartOperation(TelemetrySession, String) qui effectue le suivi des points de début et de fin.

TelemetryActivity

[OBSOLÈTE] Utilisez le modèle TelemetryScope<T> de données pour suivre les performances dans les versions dev15 et ultérieures. Pour plus d’informations, consultez http://aka.ms/datamodel.

TelemetryComplexProperty

Cette classe représente une prise en charge de valeurs complexes, comme les tableaux, les dictionnaires. Le processeur le convertit en chaîne JSON. En outre, pour ces types, nous assouplissons les restrictions de 1K pour la valeur de propriété.

TelemetryContext

Le contexte de télémétrie est un concept d’unité de travail. Vous trouverez plus de détails ici.

TelemetryDataModelProperty

Cette classe représente une propriété de modèle de données.

TelemetryDisposableObject

Classe de base d’assistance pour fournir une méthode virtuelle pour libérer des ressources managées et empêcher d’appeler Dispose plusieurs fois.

TelemetryEvent

La classe représente un événement de télémétrie qui peut être publié sur un serveur. La classe n’est PAS thread-safe

TelemetryEventMatchByName

Cette classe est utilisée pour représenter un filtre de télémétrie par nom d’événement de télémétrie.

TelemetryHashedProperty

Cette classe représente une propriété qui doit être hachée. Pendant le traitement, la valeur brute contenue est transformée en valeur hachée par un algorithme de chiffrement.

TelemetryMetricProperty

Cette classe représente une propriété de métrique de modèle de données. Le nom de la propriété sera mis à jour avec un suffixe ». DataModelMetric » lorsque l’événement est publié. Une métrique est une valeur ou un nombre agrégé collecté en tant que mesure d’une caractéristique particulière du système. Par exemple, les métriques d’utilisation telles que la taille du fichier, le nombre de projets, la taille de chargement ; des métriques de performances comme la durée.

TelemetryPiiProperty

Cette classe représente une propriété d’informations d’identification personnelle. Pendant le traitement, la valeur brute contenue est transformée en valeur hachée par un algorithme de chiffrement.

TelemetryPropertyBag

TelemetryPropertyBag est destiné aux propriétés d’ajout aux événements subscibed

TelemetryPropertyBags

Collections des sacs de propriétés

TelemetryPropertyBags.Concurrent<TValue>

Conteneur de propriétés simultanées

TelemetryResultStrings

Classe qui définit les chaînes utilisées pour la propriété Result.

TelemetryScope<T>

Cette classe est utilisée pour envoyer des événements de modèle de données pour une application fonctionnant avec la durée et le résultat. L’événement peut être ou UserTaskEventOperationEvent Il envoie un événement au début et l’autre à la fin du travail.

TelemetryScopeSettings

Cette classe est destinée à encapsuler les paramètres utilisés pour contrôler le comportement de TelemetryScope lors de la création d’un instance de celui-ci.

TelemetryService

Classe de télémétrie principale. Il a un objet de session par défaut.

TelemetrySession

Représente une session de télémétrie qui peut publier des événements de télémétrie et des propriétés de session. L’API fait le meilleur effort pour fournir des données de télémétrie au serveur. Les requêtes sont mises en file d’attente et envoyées par lots. Les événements sont enregistrés localement s’ils ne peuvent pas être envoyés avant la fin du processus. L’envoi reprendra lorsque l’application suivante instance appelle l’API de télémétrie. La télémétrie peut être perdue en cas de non-réponse du processus ou d’incident mortel ou d’absence de connexion Internet pendant 30 jours. Toutes les méthodes sont thread-safe et retournent immédiatement.

TelemetrySessionCommandLineExtensions

Méthodes d’extension pour TelemetrySession publier des arguments de ligne de commande.

TelemetrySessionExtensions

Classe pour contenir toutes les méthodes d’extension de modèle de données pour la classe existante TelemetrySession.

TelemetrySettingProperty

Cette classe représente une propriété de paramètre de modèle de données. Le nom de la propriété sera mis à jour avec un suffixe ». DataModelSetting » lorsque l’événement est publié. Un paramètre est quelque chose que l’utilisateur peut personnaliser la valeur pour modifier l’apparence/sensation/comportement de l’application. Par exemple, tous les paramètres dans la boîte de dialogue options des outils VS. Les propriétés au niveau de l’ordinateur ou de l’environnement ne sont PAS des paramètres. Ils doivent être affichés en tant que propriétés régulières. Par exemple, nombre d’uc, paramètres régionaux du système d’exploitation.

TelemetryTestChannelEventArgs

Arguments du canal de test

UserTaskEvent

Classe qui stocke des informations pour l’événement de modèle de données de tâche utilisateur. Une tâche utilisateur est une opération d’application qui est APPELÉE PAR L’UTILISATEUR directement et qui est fournie avec le résultat (par exemple, Réussite, Échec). Il est utilisé pour l’analyse du comportement/intention de l’utilisateur. L’utilisateur est au courant de l’opération et peut s’exécuter. Par exemple, Ouvrir le projet et Afficher les fenêtres de l’outil sont des tâches utilisateur ; au lieu de cela, chargez le package VS et la génération au moment de la conception sont des opérations.

Pour une tâche utilisateur de longue durée ou asynchrone, pour comprendre ce qui s’est passé pendant le temps ou suivre si elle se termine partiellement en raison d’une erreur, utilisez la méthode StartUserTask(TelemetrySession, String) qui effectue le suivi des points de début et de fin.

Structures

TelemetryEventCorrelation

struct pour définir les informations de corrélation.

Interfaces

IAssetProvider

Interface implémentée par le fournisseur d’actifs pour proposer un ID de corrélation de ressource à la demande.

IFaultUtility

Interface pour FaultCallback également utilisée pour les appelants de code natif

ISetTelemetrySession

TelemetryNotificationService.Default et TelemetryService.DefaultSession

ITelemetryEtwProvider

Implémentation du fournisseur ETW spécifique à l’hôte pour les événements de télémétrie.

ITelemetryEventMatch

Représente un filtre d’événements de télémétrie.

ITelemetryManifestRouteArgs

Interface ITelemetryManifestRouteArgs pour les arguments fournis au routeur

ITelemetryPropertyBag<TValue>

Interface ITelemetryPropertyBag pour le PropertyBag générique

ITelemetryTestChannel

Interface pour que les canaux de test reçoivent des événements

Énumérations

DataModelEventType

Type d’événement data model pris en charge

FaultSeverity

Indicateur de la gravité d’une erreur donnée en fonction de l’importance ou de l’impact anticipé. Les erreurs plus graves seront promues plus haut dans les rapports, et les erreurs moins graves seront supprimées.

OperationStageType

Énumération pour définir le type d’étape d’opération. Ne modifiez pas le nom de l’énumération, car il fait partie du contrat client-serveur.

TelemetryResult

Énumération pour définir le résultat d’une tâche ou d’une opération utilisateur.

TelemetrySeverity

Énumération pour définir la gravité de l’événement de télémétrie. Il est utilisé pour tout consommateur de données qui souhaite classer les données en fonction de leur gravité.

WER_DUMP_TYPE

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