Поделиться через


Microsoft.VisualStudio.Telemetry Пространство имен

Классы

AssetEvent

Класс, хранящий сведения о событии ресурса. Ресурс — это целевой объект задачи или операции пользователя, например решение, проект, файл, расширение, лицензия Designer.

AssetService

Класс, предоставляющий вспомогательные методы как для потребителя ресурса, так и для поставщиков. Потребители могут использовать этот класс для получения корреляции с помощью метода GetCorrelation. Поставщики могут зарегистрировать существующую корреляцию в этой службе с помощью метода RegisterCorrelation или (и) зарегистрировать себя с помощью метода RegisterProvider для отправки событий активов и возврата корреляции по запросу потребителей.

DataModelEventNameHelper

Вспомогательный класс для проверки соответствия имени события схеме имени события модели данных и задания свойств на основе имени. Ниже приведена схема имени события модели данных. Для нее требуется, чтобы имя события было уникальным, а не пустой строкой. Он состоит из 3 частей и должен соответствовать шаблону [product]/[featureName]/[entityName]. FeatureName может быть одноуровневой функцией или иерархией функций, разделенной "/". Например, vs/platform/opensolution; vs/platform/editor/lightbulb/fixerror;

FaultEvent

Событие телеметрии, представляющее ошибку, например исключение. У нас есть 2 внутренних сервера для отправки данных: телеметрия и Ватсон (внутренний). Кроссплатформенный (как в Mac, Linux) мы можем использовать ту же архитектуру. Например, на Mac есть Merp, реализация Max отчеты об ошибках Windows. FaultEvent наследует от TelemetryEvent Пользователь может создать экземпляр этого класса напрямую и добавлять пользовательские свойства непосредственно в класс без использования обратного вызова. Создав один из них, вызовите Session.PostFault(faultEvent), который вызовет обратный вызов, опубликуйте событие в Watson (если выборка) и Post в качестве обычного события телеметрии. Вы можете использовать TelemetrySession.PostFault() вместо этого класса напрямую.

JsonCreationConverter<T>

Абстрактный базовый класс служит базовым классом для создателей объектов во время десериализации объектов из JSON с помощью Newtonsoft.Json.

OperationEvent

Класс, хранящий сведения для события модели данных операции. Операция выполняет определенную работу в приложении и возвращает результат (например, Успешно, Сбой). Если операция вызывается пользователем напрямую, используйте UserTaskEvent или связанные методы. Несколько примеров операций: проверка лицензий, загрузка пакетов, загрузка макета windows.

Для длительной или асинхронной операции, чтобы понять, что еще произошло в течение этого времени, или отслеживать, если она частично завершается из-за ошибки, используйте метод StartOperation(TelemetrySession, String) , который отслеживает начальную и конечную точки.

TelemetryActivity

[УСТАРЕЛО] Используйте модель TelemetryScope<T> данных для отслеживания производительности в dev15 и более поздних выпусках. Дополнительные сведения см. по адресу http://aka.ms/datamodel.

TelemetryComplexProperty

Этот класс представляет поддержку сложных значений, таких как массивы, словари. Обработчик преобразует его в строку JSON. Кроме того, для таких типов мы ослабляем ограничения 1K для значения свойства.

TelemetryContext

Контекст телеметрии — это концепция единицы работы. Дополнительные сведения приведены здесь

TelemetryDataModelProperty

Этот класс представляет свойство модели данных.

TelemetryDisposableObject

Вспомогательный базовый класс для предоставления виртуального метода для освобождения управляемых ресурсов и предотвращения вызова Dispose несколько раз.

TelemetryEvent

Класс представляет событие телеметрии, которое может быть опубликовано на сервере. Класс НЕ является потокобезопасным

TelemetryEventMatchByName

Этот класс используется для представления фильтра телеметрии по имени события телеметрии.

TelemetryHashedProperty

Этот класс представляет свойство, которое должно быть хэшировано. Во время обработки содержащееся необработанное значение будет преобразовано алгоритмом шифрования в хэшированные значения.

TelemetryMetricProperty

Этот класс представляет свойство метрики модели данных. Имя свойства будет обновлено суффиксом ". DataModelMetric" при публикации события. Метрика — это значение или агрегированное число, собираемое в качестве измерения определенной характеристики системы. Например, метрики использования, такие как размер файла, число проектов, размер отправки; метрика производительности, например длительность.

TelemetryPiiProperty

Этот класс представляет свойство личной информации. Во время обработки содержащееся необработанное значение будет преобразовано алгоритмом шифрования в хэшированные значения.

TelemetryPropertyBag

TelemetryPropertyBag предназначен для добавления свойств к вложенным событиям.

TelemetryPropertyBags

Коллекции контейнеров свойств

TelemetryPropertyBags.Concurrent<TValue>

Контейнер свойств concurrent

TelemetryResultStrings

Класс, определяющий строки, используемые для свойства Result.

TelemetryScope<T>

Этот класс используется для отправки событий модели данных для работы приложения с длительностью и результатом. Событие может быть либо UserTaskEvent , либо OperationEvent оно отправляет одно событие в начале, а другое — в конце работы.

TelemetryScopeSettings

Этот класс предназначен для завершения параметров, используемых для управления поведением TelemetryScope при создании экземпляра.

TelemetryService

Базовый класс телеметрии. Он имеет объект сеанса по умолчанию.

TelemetrySession

Представляет один сеанс телеметрии, который может публиковать события телеметрии и свойства сеанса. API делает все возможное для доставки данных телеметрии на сервер. Запросы помещаются в очередь и отправляются пакетами. События будут сохранены локально, если они не могут быть отправлены до завершения процесса. Отправка возобновится, когда следующий экземпляр приложения вызывает API телеметрии. Данные телеметрии могут быть потеряны в случае отсутствия ответа на запросы или неустранимого сбоя или отсутствия подключения к Интернету в течение 30 дней. Все методы являются потокобезопасными и возвращаются немедленно.

TelemetrySessionCommandLineExtensions

Методы расширения для TelemetrySession отправки аргументов командной строки.

TelemetrySessionExtensions

Класс, содержащий все методы расширения модели данных для существующего класса TelemetrySession.

TelemetrySettingProperty

Этот класс представляет свойство параметра модели данных. Имя свойства будет обновлено суффиксом ". DataModelSetting" при публикации события. Параметр — это то, что пользователь может настроить значение, чтобы изменить внешний вид, поведение и поведение приложения. Например, все параметры в диалоговом окне параметров средств VS. Свойства уровня компьютера или среды НЕ являются параметрами. Они должны публиковаться как обычные свойства. Например, количество ЦП, языковой стандарт ОС.

TelemetryTestChannelEventArgs

Аргументы канала тестирования

UserTaskEvent

Класс, хранящий сведения о событии модели данных задачи пользователя. Задача пользователя — это операция приложения, которая вызывается пользователем напрямую и поставляется с результатом (например, Успешно, Сбой). Он используется для анализа поведения и намерений пользователя. Пользователь знает об операции и сможет ее выполнить. Например, открыть окно проекта и Показать окна инструментов — это задачи пользователя; Вместо этого загрузка пакета VS и сборка во время разработки являются операциями.

Для длительно выполняющейся или асинхронной задачи пользователя, чтобы понять, что еще произошло в течение этого времени, или отслеживать ее частичное завершение из-за ошибки, используйте метод StartUserTask(TelemetrySession, String) , который отслеживает начальную и конечную точки.

Структуры

TelemetryEventCorrelation

Структуру для определения сведений о корреляции.

Интерфейсы

IAssetProvider

Интерфейс, реализованный поставщиком ресурсов для предоставления идентификатора корреляции ресурсов по запросу.

IFaultUtility

Интерфейс для FaultCallback, используемый для вызывающих элементов машинного кода

ISetTelemetrySession

TelemetryNotificationService.Default и TelemetryService.DefaultSession

ITelemetryEtwProvider

Реализация поставщика трассировки событий Windows для конкретного узла для событий телеметрии.

ITelemetryEventMatch

Представляет фильтр событий телеметрии.

ITelemetryManifestRouteArgs

Интерфейс ITelemetryManifestRouteArgs для предоставления аргументов маршрутизатору

ITelemetryPropertyBag<TValue>

Интерфейс ITelemetryPropertyBag для универсального propertyBag

ITelemetryTestChannel

Интерфейс для получения событий каналами тестирования

Перечисления

DataModelEventType

Поддерживаемый тип события модели данных

FaultSeverity

Индикатор серьезности данной ошибки на основе ожидаемой важности или влияния. Более серьезные ошибки будут повышены в отчетах, а менее серьезные ошибки будут удалены.

OperationStageType

Перечисление для определения типа этапа операции. Не изменяйте имя перечисления, так как оно является частью контракта клиент-сервер.

TelemetryResult

Перечисление для определения результата пользовательской задачи или операции.

TelemetrySeverity

Перечисление для определения серьезности события телеметрии. Он используется для любого потребителя данных, который хочет классифицировать данные на основе серьезности.

WER_DUMP_TYPE

Тип дампа https://msdn.microsoft.com/en-us/library/windows/desktop/bb513622(v=vs.85).aspx