Расширения диагностики

В этой статье перечислены и описаны все расширения Microsoft.Testing.Platform, связанные с возможностями диагностики.

Встроенные параметры

Следующие параметры платформы предоставляют полезные сведения для устранения неполадок тестовых приложений:

• --info
• --diagnostic
• ⁠-⁠-⁠diagnostic-⁠filelogger-⁠synchronouswrite
• --diagnostic-verbosity
• --diagnostic-output-fileprefix
• --diagnostic-output-directory

Журналы диагностики также можно включить с помощью переменных среды:

Имя переменной среды	Описание
TESTINGPLATFORM_DIAGNOSTIC	Если задано значение 1, включает ведение журнала диагностики.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Определяет уровень детализации. Доступные значения: Trace, Debug, Information, Warning, Errorили Critical.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_DIRECTORY	Каталог вывода журнала диагностики: если не указан, файл создается в каталоге по умолчанию TestResults.
TESTINGPLATFORM_DIAGNOSTIC_OUTPUT_FILEPREFIX	Префикс имени файла журнала. По умолчанию — "log_".
TESTINGPLATFORM_DIAGNOSTIC_FILELOGGER_SYNCHRONOUSWRITE	Позволяет встроенному средству ведения журнала файлов синхронно записывать журналы. Полезно для сценариев, когда вы не хотите терять записи журнала (если процесс завершается сбоем). Это замедляет выполнение теста.

Заметка

Переменные среды имеют приоритет над аргументами командной строки.

Аварийный дамп

Это расширение позволяет создать файл аварийного дампа, если процесс завершает работу. Это расширение поставляется в составе пакета NuGet Microsoft.Testing.Extensions.CrashDump.

Это важно

Пакет поставляется с библиотекой Microsoft .NET с закрытым исходным кодом и лицензией, допускающей бесплатное использование.

Чтобы настроить создание файла аварийного дампа, используйте следующие параметры:

Выбор	Описание
--crashdump	Создает файл дампа при сбое процесса тестового узла. Поддерживается в .NET 6.0+.
⁠-⁠-⁠crashdump-⁠filename	Указывает имя файла дампа.
--crashdump-type	Указывает тип дампа. Допустимые значения: Mini, Heap, Triage, Full. По умолчанию используется Full. Дополнительные сведения см. в разделе Типы мини-дампов.

Осторожность

Расширение несовместимо с .NET Framework и будет автоматически игнорироваться. Для поддержки .NET Framework включите отладку после сбоя (postmortem debugging) с помощью Sysinternals ProcDump. Для получения дополнительной информации см. раздел Включение отладки после сбоя: окно Sysinternals ProcDump. Решение для отладки postmortem также собирает сведения о сбое процесса для .NET, чтобы вы могли избежать использования расширения, если вы нацелены на тестовые приложения как на .NET, так и на .NET Framework.

Зависание дампа

Это расширение позволяет создать файл дампа после заданного времени ожидания. Это расширение поставляется в составе пакета Microsoft.Testing.Extensions.HangDump.

Это важно

Пакет поставляется с библиотекой Microsoft .NET с закрытым исходным кодом и лицензией, допускающей бесплатное использование.

Чтобы настроить создание файла зависания дампа, используйте следующие параметры:

Выбор	Описание
--hangdump	Создает файл дампа в случае зависания процесса тестового узла.
-⁠-hangdump-filename	Указывает имя файла дампа.
--hangdump-timeout	Указывает время ожидания, после которого создается дамп. Значение времени ожидания указывается в одном из следующих форматов: 1.5h, , 1.5hour1.5hours 90m, , 90min90minute90minutes 5400s, , 5400sec5400second5400seconds. По умолчанию 30m (30 минут).
--hangdump-type	Указывает тип дампа. Допустимые значения: Mini, Heap, Triage, Full. По умолчанию используется Full. Дополнительные сведения см. в разделе Типы мини-дампов.