다음을 통해 공유

진단 확장

  • 아티클

이 문서에서는 진단 기능과 관련된 모든 Microsoft Testing Platform 확장을 나열하고 설명합니다.

기본 제공 옵션

다음 플랫폼 옵션은 테스트 앱 문제를 해결하는 데 유용한 정보를 제공합니다.

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

환경 변수를 사용하여 진단 로그를 사용하도록 설정할 수도 있습니다.

Environment variable name 설명
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 기본 제공된 파일 로거가 동기적으로 로그를 쓰도록 강제합니다. 로그 항목을 잃지 않으려는 시나리오에 유용합니다(프로세스가 충돌하는 경우). 이로 인해 테스트 실행 속도가 느려집니다.

참고 항목

환경 변수는 명령줄 인수보다 우선합니다.

크래시 덤프

이 확장을 사용하면 프로세스가 충돌할 경우 크래시 덤프 파일을 만들 수 있습니다. 이 확장은 Microsoft.Testing.Extensions.CrashDump NuGet 패키지의 일부로 제공됩니다.

Important

패키지는 라이선스 모델을 무료로 사용할 수 있는 Microsoft .NET 라이브러리 비공개 원본과 함께 제공됩니다.

크래시 덤프 파일 생성을 구성하려면 다음 옵션을 사용합니다.

옵션 설명
--crashdump 테스트 호스트 프로세스가 충돌할 때 덤프 파일을 생성합니다. .NET 6.0 이상에서 지원됩니다.
⁠-⁠-⁠crashdump-⁠filename 덤프의 파일 이름을 지정합니다.
--crashdump-type 덤프 형식을 지정합니다. 유효한 값은 Mini, Heap, Triage, Full입니다. 기본값은 Full입니다. 자세한 내용은 미니 덤프 형식을 참조하세요.

주의

확장은 .NET Framework와 호환되지 않으며 자동으로 무시됩니다. .NET Framework 지원의 경우 Sysinternals ProcDump를 사용하여 사후 디버깅을 사용하도록 설정합니다. 자세한 내용은 사후 디버깅 사용: Window Sysinternals ProcDump를 참조하세요. 사후 디버깅 솔루션은 .NET에 대한 프로세스 크래시 정보도 수집하므로 .NET 및 .NET Framework 테스트 애플리케이션을 모두 대상으로 하는 경우 확장 사용을 피할 수 있습니다.

중단 덤프

이 확장을 사용하면 지정된 시간 제한 후에 덤프 파일을 만들 수 있습니다. 이 확장은 Microsoft.Testing.Extensions.HangDump 패키지의 일부로 제공됩니다.

Important

패키지는 라이선스 모델을 무료로 사용할 수 있는 Microsoft .NET 라이브러리 비공개 원본과 함께 제공됩니다.

정지 덤프 파일 생성을 구성하려면 다음 옵션을 사용합니다.

옵션 설명
--hangdump 테스트 호스트 프로세스가 중단되는 경우 덤프 파일을 생성합니다.
-⁠-⁠hangdump-⁠filename 덤프의 파일 이름을 지정합니다.
--hangdump-timeout 덤프가 생성된 후의 시간 제한을 지정합니다. 시간 제한 값은 다음 형식 중 하나로 지정됩니다.
1.5h, 1.5hour, 1.5hours
90m, 90min, 90minute, 90minutes
5400s, 5400sec, 5400second, 5400seconds. 기본값은 30m(30분)입니다.
--hangdump-type 덤프 형식을 지정합니다. 유효한 값은 Mini, Heap, Triage, Full입니다. 기본값은 Full입니다. 자세한 내용은 미니 덤프 형식을 참조하세요.