다음을 통해 공유

진단 확장

이 문서에서는 진단 기능과 관련된 모든 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 기본 제공 파일 로거가 로그를 동기적으로 작성하도록 합니다. 로그 항목을 손실하지 않으려는 시나리오에 유용합니다(프로세스가 충돌하는 경우). 이렇게 하면 테스트 실행 속도가 느려집니다.

메모

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

크래시 덤프

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

중요하다

패키지는 비공개 소스인 Microsoft .NET 라이브러리와 함께 제공되며, 무료 사용 라이선스 모델이 적용됩니다.

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

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

주의

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

덤프 중단

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

중요하다

패키지는 비공개 소스인 Microsoft .NET 라이브러리와 함께 제공되며, 무료 사용 라이선스 모델이 적용됩니다.

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

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