Microsoft.VisualStudio.Telemetry Espace de noms
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 |