次の方法で共有

診断拡張機能

この記事では、診断機能に関連するすべての 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 パッケージの一部として出荷されます。

Von Bedeutung

このパッケージは、Microsoft .NET ライブラリのクローズドソースで無料使用可能なライセンシングモデルを備えています。

クラッシュ ダンプ ファイルの生成を構成するには、次のオプションを使用します。

選択肢 説明
--crashdump テスト ホスト プロセスがクラッシュしたときにダンプ ファイルを生成します。 .NET 6.0 以降でサポートされています。
⁠-⁠-⁠crashdump-⁠filename ダンプのファイル名を指定します。
--crashdump-type ダンプの種類を指定します。 有効な値は、 Mini、 Heap、 Triage、 Fullです。 既定値は Full です。 詳細については、「 ミニ ダンプの種類」を参照してください。

注意事項

拡張機能は .NET Framework と互換性がありません。暗黙的に無視されます。 .NET Framework のサポートでは、Sysinternals ProcDump を使用して事後デバッグを有効にします。 詳細については、「 事後デバッグの有効化: ウィンドウ Sysinternals ProcDump」を参照してください。 事後デバッグ ソリューションでは.NET のプロセス クラッシュ情報も収集されるため、.NET と .NET Framework の両方のテスト アプリケーションを対象としている場合は、拡張機能の使用を回避できます。

ハング ダンプ

この拡張機能を使用すると、特定のタイムアウト後にダンプ ファイルを作成できます。 この拡張機能は、 Microsoft.Testing.Extensions.HangDump パッケージの一部として出荷されます。

Von Bedeutung

このパッケージは、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 です。 詳細については、「 ミニ ダンプの種類」を参照してください。