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

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

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

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

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

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

Environment variable name	Description
TESTINGPLATFORM_DIAGNOSTIC	Если задано значение 1, включает ведение журнала диагностики.
TESTINGPLATFORM_DIAGNOSTIC_VERBOSITY	Определяет уровень детализации. Доступные значения: Trace, Debug, Information, WarningErrorили 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, FullTriage. Значение Fullпо умолчанию . Дополнительные сведения см. в разделе "Типы мини-дампов".

Внимание

Расширение несовместимо с платформа .NET Framework и будет автоматически игнорироваться. Для поддержки платформа .NET Framework включите отладку postmortem с помощью Sysinternals ProcDump. Дополнительные сведения см. в разделе "Включение отладки Postmortem: Window 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, FullTriage. Значение Fullпо умолчанию . Дополнительные сведения см. в разделе "Типы мини-дампов".