FaultEvent Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Событие телеметрии, представляющее ошибку, например исключение, которое содержит 2 задних конца для отправки данных: Серверная запись телеметрии и Watson (серверная части). Кросс-платформенный (как в Mac, Linux) можно использовать ту же архитектуру. Например, на компьютерах Mac Мерп максимальная реализация отчеты об ошибках Windows. Фаултевент наследует от Телеметревент пользователь может напрямую создать экземпляр этого класса и добавить пользовательские свойства непосредственно в класс без использования метода Back. После создания одного из них вызовите Session. i-Fault (Фаултевент), который будет вызывать обратный вызов, опубликовать событие в Watson (если выборка) и POST в качестве обычного события телеметрии, либо можно использовать Телеметрисессион. () вместо этого класса напрямую.
public ref class FaultEvent sealed : Microsoft::VisualStudio::Telemetry::TelemetryEvent, Microsoft::VisualStudio::Telemetry::IFaultUtility
public sealed class FaultEvent : Microsoft.VisualStudio.Telemetry.TelemetryEvent, Microsoft.VisualStudio.Telemetry.IFaultUtility
type FaultEvent = class
inherit TelemetryEvent
interface IFaultUtility
Public NotInheritable Class FaultEvent
Inherits TelemetryEvent
Implements IFaultUtility
- Наследование
- Реализации
Конструкторы
| FaultEvent(String, String, Exception, Func<IFaultUtility,Int32>) |
Создайте Фаултевент без категорий серьезности. Шаблон: 1. Февент = New Фаултевент (...) открыт. тсессион. Четный (Февент)//Постс событие в Watson и внешние пользователи AI должны вызывать методы расширения Телеметрисессион "Неисправность" (которая вызывает функцию ""), которая больше полезна при корреляции с UserTaskEvent или OperationEvent , что может привести к возникновению сбоя. |
| FaultEvent(String, String, FaultSeverity, Exception, Func<IFaultUtility,Int32>) |
Создайте Фаултевент. Шаблон: 1. Февент = New Фаултевент (...) открыт. тсессион. Четный (Февент)//Постс событие в Watson и внешние пользователи AI должны вызывать методы расширения Телеметрисессион "Неисправность" (которая вызывает функцию ""), которая больше полезна при корреляции с UserTaskEvent или OperationEvent , что может привести к возникновению сбоя. |
Поля
| BucketFiltersToAddProcessDump |
Возвращает или задает фильтры, используемые для добавления дампов процесса в события сбоя, соответствующие заданному набору параметров контейнера. |
| BucketFiltersToDisableWatsonReport |
Возвращает или задает фильтры, используемые для отключения отчетов программы Watson о событиях сбоя, соответствующих заданному набору параметров контейнера. |
Свойства
| Correlation |
Возвращает корреляцию этого события. Он представляет это событие при взаимосвязи с другими событиями. (Унаследовано от TelemetryEvent) |
| DataSource |
Возвращает источник данных. (Унаследовано от TelemetryEvent) |
| DumpCollectionType |
Возвращает или задает тип дампа, созданный для Аддпроцессдумп и отправленный в Watson Аддпроцессдумп, указывает, какие процессы следует дампировать, а Думпколлектионтипе определяет тип дампа для получения полной копии кучи, присвойте этому параметру значение WER_DUMP_TYPE. Вердумптипехеапдумп. Например, (EV AS Фаултевент). Думпколлектионтипе = WER_DUMP_TYPE. Вердумптипехеапдумп; Другим способом задать это свойство является добавление обычного свойства телеметрии в контейнер свойств Телеметревент, например Фаултевент. Properties ["ДУМПКОЛЛЕКТИОНТИПЕ"] = "вердумптипехеапдумп"; работает из машинного кода, использует Enum. Parse без учета регистра. Параметр контейнера свойств (доступный из машинного кода) переопределяет значение свойства (которое гораздо более обнаруживается в IntelliSense) при вызове Телеметрисессион. i (Фаултевент), Веррепортадддумп вызывается для каждого процесса в Аддпроцесдумп с указанным Думпколлектионтипе. Все создаваемые процессы будут иметь одинаковые Думпколлектионтипе. Вы можете управлять типом дампа (и даже отправкой дампа) через удаленные параметры в ответном вызове Гасеревентдетаилс очень полезно для сбора дампов кучи в редких случаях, которые очень трудно отладить. После устранения проблемы удаленные параметры могут отключить эту функцию. Значение по умолчанию — WER_DUMP_TYPE. вердумптипеминидумп |
| EventSchemaVersion |
Возвращает версию схемы для этого события. (Унаследовано от TelemetryEvent) |
| EventType |
Возвращает тип события для этого события (Унаследовано от TelemetryEvent) |
| HasProperties |
Возвращает значение, указывающее, созданы ли уже свойства. (Унаследовано от TelemetryEvent) |
| IsIncludedInWatsonSample |
Возвращает или задает значение, указывающее, будет ли это событие рассмотрено локально. Затрагивает только Watson. Если значение равно false, не будет отправляться в Watson: отправляет событие телеметрии только в AI и не вызывает обратный вызов. При изменении этого события будет принудительно отправлена в Watson. Будьте внимательны, так как это может оказать значительное влияние на производительность. Если этот параметр не изменен, он будет установлен в соответствии с частотой выборки по умолчанию. См. раздел Microsoft.VisualStudio.Telemetry.WindowsErrorReporting.WatsonReport.DefaultWatsonSamplePercent. |
| IsOptOutFriendly |
Возвращает или задает значение, указывающее, является ли событие понятным для сеанса optOut. По умолчанию используется значение false. Если он является понятным, он проходит только со свойствами события. Это поведение можно изменить с помощью правил манифеста. (Унаследовано от TelemetryEvent) |
| MaximumWatsonReportsPerSession |
Возвращает или задает максимальное число событий сбоя, которые будут переданы в Watson во время сеанса телеметрии. |
| MinimumSecondsBetweenWatsonReports |
Возвращает или задает минимальное число секунд, которое должно пройти после отправки отчета Watson для события сбоя, прежде чем можно будет отправить другой отчет. |
| Name |
Возвращает имя текущего события (Унаследовано от TelemetryEvent) |
| Properties |
Возвращает словарь свойств события. Свойства — это измерения, по которым могут быть разделены агрегированные данные. Ключ — это имя свойства, которое является уникальным, а не NULL и не пусто. Значением является любой объект, представляющий значение свойства. Каналы телеметрии должны использовать значение. ToString (CultureInfo. InvariantCulture) для отправки значения на сервер в виде строки. (Унаследовано от TelemetryEvent) |
| Severity |
Возвращает или задает уровень серьезности события. Уровень используется для потребителей событий (например, поставщик ETW, серверные отчеты) для упрощения организации данных. (Унаследовано от TelemetryEvent) |
| SharedPropertyBags |
Получение контейнеров общих свойств (Унаследовано от TelemetryEvent) |
| SynchronousDumpCollection |
Возвращает или задает значение, указывающее, записывается ли файл дампа синхронно или в ThreadPool. При сборе дампа из-за нехватки ThreadPool мы не будем использовать ThreadPool для сбора дампа (ThreadPool недоступен, а время выполнения кода дампа — пул сток). |
| WatsonEventType |
Возвращает или задает тип события, зарегистрированный в серверной части Watson, например "VisualStudioNonFatalErrors2". Все «обычные» Фаултевентс должны переключиться на VisualStudioNonFatalErrors2 различные типы событий Watson ведут себя по-разному. Например, политика # и хранение собранных CAB — маршрутизация CAB. Например, "Висуалстудиомемватсон" используется для получения потока CAB-файлов, которые должны обрабатываться серверной частью Перфватсон. Эти события можно запрашивать из http://Watson . |
| WatsonSamplePercent |
Возвращает или задает частоту выборки, используемую для определения того, будет ли передаваться сообщение о сбое в Watson. Событие сбоя поддается отчету Watson, если он был изменен по крайней мере одним из следующих методов: 1) Аддерроринформатион 2) AddFile 3) Аддпроцессдумп |
Методы
| AddErrorInformation(String) |
Каждый блок CAB-файла Watson включает текстовый файл (ErrrorInformation.txt) с основными сведениями, такими как Error. ToString, свойства телеметрии и т. д. Вызовите этот метод, чтобы добавить сведения в файл. Это позволяет создать уникальное имя временного файла на экземпляр и добавить стандартную информацию Примечание. вызов этого приведет к тому, что ErrorInformation.txt будет отмечено для персональных данных и, таким образом, блокировать передачу CAB-файла, пока не будут заполнены параметры телеметрии пользователей. |
| AddFile(String) |
Добавление файла в отчет, отправляемый обратно в корпорацию Майкрософт |
| AddProcessDump(Int32) |
Примечание. при использовании Фаултевент из VisualStudio настоятельно рекомендуется не вызывать Аддпроцессдумп напрямую для текущего процесса, а удаленно запускать его с целевым уведомлением. Для получения дополнительных сведений выполните поиск по запросу "применение фильтров контейнеров к СОБЫТИЯм сбоя" в репозитории VS. Добавление идентификатора процесса, для которого требуется собирать коллекцию дампов дампа, не происходит, если серверная часть Watson не запрашивает дамп. Вы можете запросить дамп кучи для определенного контейнера на портале Watson: https://watsonportal.microsoft.com/ . Сбор данных дампа не обрабатывается, чтобы снизить вероятность взаимоблокировки |
| Correlate(TelemetryEventCorrelation[]) |
Сопоставьте это событие с другими событиями через TelemetryEventCorrelation . (Унаследовано от TelemetryEvent) |
| CorrelateWithDescription(TelemetryEventCorrelation, String) |
Сопоставьте это событие с другим событием через TelemetryEventCorrelation со сведениями о описании. (Унаследовано от TelemetryEvent) |
| GetBucketParameter(Int32) |
Получение значения параметра контейнера |
| GetDefaultEventProperties(Int64, Int64, String) |
Возвращает свойства по умолчанию, которые должны быть в каждом Телеметревент (Унаследовано от TelemetryEvent) |
| SetAppName(String) |
Установите параметр контейнера с именем зарегистрированного в списке ошибки имени приложения как обработанное в Watson и других. Это значение автоматически задается в большинстве экземпляров. Имя сообщаемого приложения следует изменять только в особых обстоятельствах, когда данные телеметрии отчетов приложений не являются также приложениями, на которых возникла ошибка. |
| SetAppVersion(String) |
Установите параметр контейнера с атрибутом "версия приложения, сообщаемая сбоем", как обработанный в Watson и других. Это значение автоматически задается в большинстве экземпляров. Версию сообщаемого приложения следует изменять только в особых обстоятельствах, когда данные телеметрии отчетов приложений не являются также приложениями, на которых возникла ошибка. |
| SetBucketParameter(Int32, String) |
Задание параметра контейнера для проблемы с Watson не должно содержать полных путей к файлам или PII уникальный набор из 10 параметров контейнеров, конституес Буккетид, который считается тем же сбоем. При передаче объекта исключения параметры контейнера задаются параметром Iclrerrorreportingmanagergetbucketparametersforcurrentexception:: Жетбуккетпараметерсфоркуррентексцептион |
| SetFailureParameters(String, String, String, String, String) |
Задайте параметры контейнера, составляющие уникальный идентификатор сбоя для сообщаемого сбоя, как обработанные в Watson и других. Параметры сбоя, которые остались неопределенными, или при передаче значения NULL сохраняют свое исходное значение по умолчанию. Дополнительную документацию см. на вики-сайте Девдив. Это рекомендуемый API, используемый для настройки уникального процесса идентификации сбоев для ошибок команды. |
| SetNonFailureParameters(String, String) |
Задайте параметры контейнера, которые составлять параметры, не относящиеся к сбою, как обработанные в Watson и других. Параметры, оставшиеся неопределенными или переданные по значению NULL, сохраняют свое исходное значение по умолчанию. |
| ToString() |
ToString, чтобы упростить отладку: показывать в окне контрольных значений отладки |