次の方法で共有

診断拡張機能

  • [アーティクル]

この記事では、診断機能に関連するすべての 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 組み込みのファイル ロガーにログの同期的な書き込みを強制します。 (プロセスがクラッシュした場合に) ログ エントリを少しも失いたくないときのシナリオに役立ちます。 これにより、テストの実行速度は低下します。

Note

環境変数は、コマンド ライン引数よりも優先されます。

クラッシュ ダンプ

この拡張機能を使用すると、プロセスがクラッシュした場合にクラッシュ ダンプ ファイルを作成できます。 この拡張機能は、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 を使って事後検証デバッグを有効にします。 詳細については、事後検証デバッグの有効化: Window Sysinternals ProcDump に関する記事を参照してください。 事後検証デバッグ ソリューションでは、.NET のプロセス クラッシュ情報も収集されるため、.NET と .NET Framework の両方のテスト アプリケーションを対象にしている場合は、拡張機能の使用を避けることができます。

ハング ダンプ

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

重要

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