Freigeben über


Microsoft.VisualStudio.Telemetry Namespace

Klassen

AssetEvent

Eine Klasse, die Informationen für das Medienobjektereignis speichert. Die Ressource ist das Ziel der Benutzeraufgabe oder des Vorgangs, z. B. Projektmappe, Projekt, Datei, Erweiterung, Lizenz, Designer.

AssetService

Eine Klasse, die Hilfemethoden sowohl für Ressourcenverbraucher als auch für Anbieter bereitstellt. Consumer können diese Klasse verwenden, um die Korrelation über die GetCorrelation-Methode abzurufen. Anbieter können vorhandene Korrelationen in diesem Dienst über die Methode RegisterCorrelation registrieren oder sich selbst über die Methode RegisterProvider registrieren, um Medienobjektereignisse zu senden und die Korrelation pro Consumeranforderung zurückzugeben.

DataModelEventNameHelper

Eine Hilfsklasse, um zu überprüfen, ob der Ereignisname dem Schema des Datenmodellereignisnamens entspricht, und um eigenschaften basierend auf dem Namen festzulegen. Hier ist das Schema des Datenmodellereignisnamens. Es erfordert, dass der Ereignisname eine eindeutige, keine NULL- oder leere Zeichenfolge ist. Es besteht aus drei Teilen und muss dem Muster [product]/[featureName]/[entityName] folgen. FeatureName kann ein Feature oder eine Featurehierarchie auf einer Ebene sein, die durch "/" getrennt ist. Beispiele hierfür sind vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

FaultEvent

Ein Telemetrieereignis, das einen Fehler darstellt, z. B. eine Ausnahme Wir haben zwei Back-Ends zum Senden von Daten: das Telemetrie-Back-End und das Watson (Back-End). Plattformübergreifend (wie unter Mac, Linux) können wir dieselbe Architektur verwenden. Auf dem Mac gibt es beispielsweise Merp, die Max-Implementierung von Windows-Fehlerberichterstattung. FaultEvent erbt von TelemetryEvent Benutzer kann direkt eine instance dieser Klasse erstellen und benutzerdefinierte Eigenschaften direkt für die Klasse hinzufügen, ohne rückrufen zu müssen. Nachdem Sie eine dieser Elemente erstellt haben, rufen Sie Session.PostFault(faultEvent) auf, wodurch der Rückruf aufgerufen wird, posten Sie das Ereignis an Watson (falls stichprobenhaft angegeben) und Post als normales Telemetrieereignis. Alternativ können Sie TelemetrySession.PostFault() anstelle dieser Klasse direkt verwenden.

JsonCreationConverter<T>

Abstrakte Basisklasse, dient als Basisklasse für die Objektersteller beim Deserialisieren von Objekten aus dem Json-Code mithilfe von Newtonsoft.Json

OperationEvent

Eine Klasse, die Informationen für das Vorgangsdatenmodellereignis speichert. Ein Vorgang führt einige Aufgaben in der Anwendung aus und führt zu einem Ergebnis (z. B. Erfolg, Fehler). Wenn der Vorgang direkt vom Benutzer aufgerufen wird, verwenden UserTaskEvent Sie oder verwandte Methoden. Einige Beispiele für Vorgänge sind die Lizenzprüfung, das Laden von Paketen, das Laden des Fensterlayouts.

Verwenden Sie eine Methode StartOperation(TelemetrySession, String) , die sowohl Start- als auch Endpunkte nachverfolgt, um zu verstehen, was während der Zeit noch passiert ist, oder um nachzuverfolgen, ob der Vorgang aufgrund eines Fehlers teilweise abgeschlossen wird.

TelemetryActivity

[VERALTET] Verwenden Sie das Datenmodell TelemetryScope<T> , um die Leistung in dev15- und höher-Versionen nachzuverfolgen. Weitere Informationen finden Sie unter http://aka.ms/datamodel.

TelemetryComplexProperty

Diese Klasse stellt eine unterstützung für komplexe Werte dar, z. B. Arrays, Wörterbücher. Der Prozessor konvertiert sie in die JSON-Zeichenfolge. Auch für solche Typen lockern wir die Einschränkungen des 1K für den Eigenschaftswert.

TelemetryContext

Telemetriekontext ist ein Konzept einer Arbeitseinheit. Ausführlichere Informationen finden Sie hier.

TelemetryDataModelProperty

Diese Klasse stellt eine Datenmodelleigenschaft dar.

TelemetryDisposableObject

Hilfsprogramm-Basisklasse zur Bereitstellung einer virtuellen Methode zum Freigeben verwalteter Ressourcen und verhindern, dass Dispose mehrmals aufgerufen wird.

TelemetryEvent

Die -Klasse stellt ein Telemetrieereignis dar, das an einen Server gesendet werden kann. Klasse ist NICHT threadsicher

TelemetryEventMatchByName

Diese Klasse wird verwendet, um einen Telemetriefilter nach Dem Namen des Telemetrieereignisses darzustellen.

TelemetryHashedProperty

Diese Klasse stellt eine Eigenschaft dar, die gehasht werden soll. Während der Verarbeitung wird der enthaltene Rohwert von einem Kryptologiealgorithmus in einen Hashwert umgewandelt.

TelemetryMetricProperty

Diese Klasse stellt eine Metrikeigenschaft des Datenmodells dar. Der Eigenschaftenname wird mit dem Suffix "aktualisiert. DataModelMetric", wenn das Ereignis bereitgestellt wird. Eine Metrik ist ein Wert oder eine aggregierte Anzahl, die als Maß für ein bestimmtes Merkmal des Systems erfasst wird. z.B. Nutzungsmetriken wie Dateigröße, Projektanzahl, Uploadgröße; Leistungsmetrik wie Dauer.

TelemetryPiiProperty

Diese Klasse stellt eine personenbezogene Informationseigenschaft dar. Während der Verarbeitung wird der enthaltene Rohwert von einem Kryptologiealgorithmus in einen Hashwert umgewandelt.

TelemetryPropertyBag

TelemetryPropertyBag ist für das Hinzufügen von Eigenschaften zu den untergeordneten Ereignissen vorgesehen.

TelemetryPropertyBags

Sammlungen der Eigenschaftentaschen

TelemetryPropertyBags.Concurrent<TValue>

Gleichzeitiger Eigenschaftenbehälter

TelemetryResultStrings

Eine Klasse, die die Zeichenfolgen definiert, die für die Eigenschaft Result verwendet werden.

TelemetryScope<T>

Diese Klasse wird verwendet, um Datenmodellereignisse für eine Anwendungsarbeit mit Dauer und Ergebnis zu senden. Das Ereignis kann entweder UserTaskEvent oder OperationEvent sein: Es sendet ein Ereignis am Anfang und das andere ereignis am Ende der Arbeit.

TelemetryScopeSettings

Diese Klasse dient zum Abschluss der Einstellungen, die zum Steuern des TelemetryScope-Verhaltens verwendet werden, wenn eine instance erstellt wird.

TelemetryService

Core Telemetry-Klasse. Es verfügt über ein Standardsitzungsobjekt.

TelemetrySession

Stellt eine Telemetriesitzung dar, die Telemetrieereignisse und Sitzungseigenschaften veröffentlichen kann. Die API unternimmt die besten Anstrengungen, um Telemetriedaten an den Server zu übermitteln. Die Anforderungen werden in die Warteschlange eingereiht und in Batches gesendet. Die Ereignisse werden lokal gespeichert, wenn sie nicht gesendet werden können, bevor der Prozess beendet wird. Das Senden wird fortgesetzt, wenn die nächste Anwendung die Telemetrie-API aufruft instance. Telemetriedaten können verloren gehen, wenn der Prozess nicht reagiert oder ein schwerwiegender Absturz auftritt oder 30 Tage lang keine Internetverbindung besteht. Alle Methoden sind threadsicher und geben sofort zurück.

TelemetrySessionCommandLineExtensions

Erweiterungsmethoden für TelemetrySession , um Befehlszeilenargumente zu posten.

TelemetrySessionExtensions

Eine Klasse, die alle Datenmodellerweiterungsmethoden für die vorhandene Klasse TelemetrySession enthält.

TelemetrySettingProperty

Diese Klasse stellt eine Datenmodelleinstellungseigenschaft dar. Der Eigenschaftenname wird mit dem Suffix "aktualisiert. DataModelSetting, wenn das Ereignis gepostet wird. Bei einer Einstellung kann der Benutzer den Wert anpassen, um zu ändern, wie die App aussieht/fühlt/verhält. Z. B. alle Einstellungen im Dialogfeld "Vs-Tools-Optionen". Eigenschaften auf Computerebene oder Umgebung sind KEINE Einstellungen. Sie sollten als reguläre Eigenschaften bereitgestellt werden. Z.B. CPU-Anzahl, Betriebssystemgebietsschema.

TelemetryTestChannelEventArgs

Testkanalargumente

UserTaskEvent

Eine Klasse, die Informationen für das Datenmodellereignis für Benutzeraufgaben speichert. Eine Benutzeraufgabe ist ein Anwendungsvorgang, der direkt VOM BENUTZER AUFGERUFEN wird und mit dem Ergebnis (z. B. Erfolg, Fehler) eingeht. Es wird für die Benutzerverhaltens-/Absichtsanalyse verwendet. Der Benutzer kennt den Vorgang und kann ausgeführt werden. z.B. Projekt öffnen und Toolfenster anzeigen sind Benutzeraufgaben; Laden Sie stattdessen VS-Paket und Entwurfszeitbuildvorgänge.

Verwenden Sie für eine zeitintensive oder asynchrone Benutzeraufgabe, um zu verstehen, was während der Zeit noch passiert ist, oder um nachzuverfolgen, ob sie aufgrund eines Fehlers teilweise abgeschlossen wird, die Start StartUserTask(TelemetrySession, String) - und Endpunkte nachverfolgt.

Strukturen

TelemetryEventCorrelation

Eine Struktur zum Definieren von Korrelationsinformationen.

Schnittstellen

IAssetProvider

Eine schnittstelle, die vom Ressourcenanbieter implementiert wird, um die Ressourcen korrelierte ID bei Bedarf anzubieten.

IFaultUtility

Schnittstelle für FaultCallback, die auch für native Codeaufrufer verwendet wird

ISetTelemetrySession

TelemetryNotificationService.Default und TelemetryService.DefaultSession

ITelemetryEtwProvider

Implementierung für hostspezifische ETW-Anbieter für Telemetrieereignisse.

ITelemetryEventMatch

Stellt einen Telemetrieereignisfilter dar.

ITelemetryManifestRouteArgs

ITelemetryManifestRouteArgs-Schnittstelle für die Bereitstellung von Argumenten für den Router

ITelemetryPropertyBag<TValue>

ITelemetryPropertyBag-Schnittstelle für den generischen PropertyBag

ITelemetryTestChannel

Schnittstelle für die Testkanäle zum Empfangen von Ereignissen

Enumerationen

DataModelEventType

Unterstützter Datenmodellereignistyp

FaultSeverity

Ein Indikator für den Schweregrad eines bestimmten Fehlers basierend auf der erwarteten Wichtigkeit oder Auswirkung. Schwerwiegendere Fehler werden in Berichten höher gefördert, und weniger schwerwiegende Fehler werden hervorgehoben.

OperationStageType

Eine Enumeration zum Definieren des Vorgangsstufentyps. Ändern Sie den Enumerationsnamen nicht, da er Teil des Client-Server-Vertrags ist.

TelemetryResult

Eine Enumeration zum Definieren des Ergebnisses einer Benutzeraufgabe oder eines Vorgangs.

TelemetrySeverity

Eine Enumeration zum Definieren des Schweregrads des Telemetrieereignisses. Es wird für jeden Datenconsumer verwendet, der Daten nach Schweregrad kategorisieren möchte.

WER_DUMP_TYPE

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