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 |