Microsoft.VisualStudio.Telemetry Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Classi
AssetEvent |
Classe che archivia le informazioni per l'evento asset. Asset è la destinazione dell'attività o dell'operazione dell'utente, ad esempio Soluzione, Progetto, File, Estensione, Licenza, Designer. |
AssetService |
Classe per fornire metodi della Guida sia per i consumer di asset che per i provider. I consumer possono usare questa classe per ottenere la correlazione tramite il metodo GetCorrelation. I provider possono registrare la correlazione esistente in questo servizio tramite il metodo RegisterCorrelation o(e) registrarsi tramite il metodo RegisterProvider per inviare gli eventi di asset e restituire la correlazione per richiesta dei consumer. |
DataModelEventNameHelper |
Classe helper per convalidare se il nome dell'evento è conforme allo schema del nome dell'evento del modello di dati e impostare le proprietà in base al nome. Ecco lo schema del nome dell'evento del modello di dati. È necessario che il nome dell'evento sia una stringa univoca, non null o vuota. È costituito da 3 parti e deve seguire il modello [product]/[featureName]/[entityName]. FeatureName può essere una funzionalità di un livello o una gerarchia di funzionalità delimitata da "/". Per esempi, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror; |
FaultEvent |
Evento di telemetria che rappresenta un errore, ad esempio un'eccezione Sono disponibili 2 back-end per l'invio di dati: back-end telemetria e Watson (back-end). Multipiattaforma( come in Mac, Linux), è possibile usare la stessa architettura. Ad esempio, in Mac è presente Merp, l'implementazione Max di Segnalazione errori Windows. FaultEvent eredita da TelemetryEvent User può creare direttamente un'istanza di questa classe e può aggiungere proprietà personalizzate direttamente nella classe senza usare il callback. Dopo aver creato uno di questi elementi, chiamare Session.PostFault(faultEvent) che chiamerà il callback, inviare l'evento a Watson (se campionato) e Post come normale evento di telemetria Oppure è possibile usare TelemetrySession.PostFault() anziché direttamente questa classe. |
JsonCreationConverter<T> |
Classe base astratta, funge da classe di base per gli autori di oggetti durante la deserializzazione di oggetti dal codice Json usando Newtonsoft.Json |
OperationEvent |
Classe che archivia le informazioni per l'evento del modello di dati dell'operazione. Un'operazione esegue alcune operazioni nell'applicazione e viene restituito il risultato (ad esempio, Operazione riuscita, Errore). Se l'operazione viene richiamata direttamente dall'utente, usare UserTaskEvent o metodi correlati. Alcuni esempi di operazioni sono il controllo delle licenze, il caricamento del pacchetto, il caricamento del layout di Windows. Per l'esecuzione prolungata o l'operazione asincrona, per comprendere cos'altro è accaduto durante il tempo o tenere traccia del completamento parziale a causa di un errore, usare il metodo StartOperation(TelemetrySession, String) che tiene traccia sia dei punti di inizio che di fine. |
TelemetryActivity |
[OBSOLETO] Usare il modello TelemetryScope<T> di dati per tenere traccia delle prestazioni in dev15 e versioni successive. Altri dettagli sono disponibili in http://aka.ms/datamodel. |
TelemetryComplexProperty |
Questa classe rappresenta un supporto di valori complessi, ad esempio matrici, dizionari. Il processore lo convertirà nella stringa JSON. Inoltre, per tali tipi, si riduceno le restrizioni della chiave 1K per il valore della proprietà. |
TelemetryContext |
Il contesto di telemetria è un concetto di unità di lavoro. Altri dettagli sono disponibili qui |
TelemetryDataModelProperty |
Questa classe rappresenta una proprietà del modello di dati. |
TelemetryDisposableObject |
Classe di base helper per fornire un metodo virtuale per rilasciare le risorse gestite e impedire di chiamare Dispose più volte. |
TelemetryEvent |
La classe rappresenta un evento di telemetria che può essere inviato a un server. La classe non è thread-safe |
TelemetryEventMatchByName |
Questa classe viene usata per rappresentare un filtro di telemetria in base al nome dell'evento di telemetria. |
TelemetryHashedProperty |
Questa classe rappresenta una proprietà che deve essere sottoposto a hashing. Durante l'elaborazione del valore non elaborato contenuto verrà trasformato in un valore hash da un algoritmo di crittografia. |
TelemetryMetricProperty |
Questa classe rappresenta una proprietà della metrica del modello di dati. Il nome della proprietà verrà aggiornato con un suffisso ". DataModelMetric" quando viene pubblicato l'evento. Una metrica è un valore o un conteggio aggregato raccolto come misura di una particolare caratteristica del sistema. Ad esempio, metriche di utilizzo come dimensioni del file, numero di progetti, dimensioni di caricamento; metrica delle prestazioni, ad esempio durata. |
TelemetryPiiProperty |
Questa classe rappresenta una proprietà di informazioni personali. Durante l'elaborazione del valore non elaborato contenuto verrà trasformato in un valore hash da un algoritmo di crittografia. |
TelemetryPropertyBag |
TelemetryPropertyBag è destinato all'aggiunta di proprietà agli eventi secondari |
TelemetryPropertyBags |
Raccolte dei contenitori delle proprietà |
TelemetryPropertyBags.Concurrent<TValue> |
Contenitore delle proprietà simultanee |
TelemetryResultStrings |
Classe che definisce le stringhe utilizzate per la proprietà Result. |
TelemetryScope<T> |
Questa classe viene usata per inviare eventi del modello di dati per un'applicazione che funzionano con durata e risultati. L'evento può essere UserTaskEvent o OperationEvent Invia un evento all'inizio e l'altro alla fine del lavoro. |
TelemetryScopeSettings |
Questa classe consiste nel eseguire il wrapping delle impostazioni usate per controllare il comportamento di TelemetryScope quando si crea un'istanza di tale classe. |
TelemetryService |
Classe Di telemetria di base. Ha un oggetto sessione predefinito. |
TelemetrySession |
Rappresenta una sessione di telemetria in grado di pubblicare eventi di telemetria e proprietà di sessione. L'API fa il massimo sforzo per distribuire i dati di telemetria al server. Le richieste vengono accodate e inviate in batch. Gli eventi verranno salvati in locale se non possono essere inviati prima dell'uscita del processo. L'invio riprenderà quando l'istanza dell'applicazione successiva chiama l'API di telemetria. La telemetria può essere persa in caso di mancata risposta del processo o arresto anomalo anomalo o nessuna connessione Internet per 30 giorni. Tutti i metodi sono thread-safe e restituiscono immediatamente. |
TelemetrySessionCommandLineExtensions |
Metodi di estensione per per TelemetrySession pubblicare gli argomenti della riga di comando. |
TelemetrySessionExtensions |
Classe che contiene tutti i metodi di estensione del modello di dati per la classe esistente TelemetrySession. |
TelemetrySettingProperty |
Questa classe rappresenta una proprietà dell'impostazione del modello di dati. Il nome della proprietà verrà aggiornato con un suffisso ". DataModelSetting" quando viene pubblicato l'evento. Un'impostazione è un elemento che l'utente può personalizzare il valore per modificare l'aspetto/comportamento dell'app. Ad esempio, tutte le impostazioni nella finestra di dialogo opzioni degli strumenti di Visual Studio. Le proprietà a livello di computer o ambientali non sono impostazioni. Devono essere pubblicati come proprietà regolari. Ad esempio, numero di CPU, impostazioni locali del sistema operativo. |
TelemetryTestChannelEventArgs |
Argomenti del canale di test |
UserTaskEvent |
Classe che archivia le informazioni per l'evento del modello di dati dell'attività utente. Un'attività utente è un'operazione dell'applicazione richiamata direttamente dall'utente e viene restituita come risultato(ad esempio, operazione riuscita, errore). Viene usato per l'analisi del comportamento o della finalità dell'utente. L'utente è a conoscenza dell'operazione e può essere eseguito. Ad esempio, aprire il progetto e mostrare le finestre degli strumenti sono attività utente; Caricare invece il pacchetto VS e la compilazione in fase di progettazione sono operazioni. Per l'esecuzione prolungata o l'attività utente asincrona, per comprendere cos'altro è accaduto durante il tempo o tenere traccia del completamento parziale a causa di un errore, usare il metodo StartUserTask(TelemetrySession, String) che tiene traccia sia dei punti di inizio che di fine. |
Struct
TelemetryEventCorrelation |
Struct per definire le informazioni di correlazione. |
Interfacce
IAssetProvider |
Interfaccia implementata dal provider di asset per offrire l'ID correlato agli asset su richiesta. |
IFaultUtility |
Interfaccia per FaultCallback usata anche per i chiamanti di codice nativo |
ISetTelemetrySession |
TelemetryNotificationService.Default e TelemetryService.DefaultSession |
ITelemetryEtwProvider |
Implementazione per il provider ETW specifico dell'host per gli eventi di telemetria. |
ITelemetryEventMatch |
Rappresenta un filtro di eventi di telemetria. |
ITelemetryManifestRouteArgs |
Interfaccia ITelemetryManifestRouteArgs per gli argomenti forniti al router |
ITelemetryPropertyBag<TValue> |
Interfaccia ITelemetryPropertyBag per propertyBag generico |
ITelemetryTestChannel |
Interfaccia per i canali di test per ricevere eventi |
Enumerazioni
DataModelEventType |
Tipo di evento del modello di dati supportato |
FaultSeverity |
Indicatore della gravità di un determinato errore in base all'importanza o all'impatto previsti. Gli errori più gravi saranno promossi più in alto nei report e gli errori meno gravi saranno de-enfatizzati. |
OperationStageType |
Enumerazione per definire il tipo di fase dell'operazione. Non modificare il nome dell'enumerazione perché fa parte del contratto client-server. |
TelemetryResult |
Enumerazione per definire il risultato dell'attività o dell'operazione dell'utente. |
TelemetrySeverity |
Enumerazione per definire la gravità dell'evento di telemetria. Viene usato per qualsiasi consumer di dati che desidera classificare i dati in base alla gravità. |
WER_DUMP_TYPE |
Tipo di dump https://msdn.microsoft.com/en-us/library/windows/desktop/bb513622(v=vs.85).aspx |