ライブ プロセスのデバッグとダンプ分析ユーティリティ (dotnet-debug)

この記事の対象: ✔️ dotnet-debug バージョン 0.0.710501 以降のバージョン

Install

dotnet-debug NuGet パッケージの最新のリリース バージョンをインストールするには、次のように dotnet tool install コマンドを使用します。

dotnet tool install --global dotnet-debug

概要

dotnet-debug [-h|--help] [--version] <command>

Description

dotnet-debug グローバル ツールを使用すると、ライブ .NET プロセスにアタッチし、ダンプ ファイルを対話形式で分析できます。 ダンプ収集とオフライン分析に焦点を当てた dotnet-dumpとは異なり、 dotnet-debug はライブ プロセス検査用に設計されています。 と同じ dotnet-dumpがすべてサポートされます。

このツールは、完全に動作する lldb が利用できない Alpine Linux などのプラットフォームで役立ちます。 dotnet-debug ツールは SOS コマンドを実行してマネージド状態とヒープの診断を分析しますが、ネイティブ デバッガーではないので、ネイティブ スタック フレームの表示はサポートされていません。

オプション

• --version

  dotnet-debug ユーティリティのバージョンを表示します。

• -h|--help

  コマンド ライン ヘルプを表示します。

Commands

dotnet-debug attach

ライブ プロセスにアタッチし、デバッグ コマンドを使用して対話型シェルを開始して探索します。

概要

dotnet-debug attach <process-id> [-c|--commands <debug_command>] [--accept-license-agreement]

論争

• <process-id>

  アタッチして分析するプロセス ID。

オプション

• -c|--commands <debug_command>

  起動時にコマンドを実行します。 1 つの呼び出しでこのパラメーターの複数インスタンスを使って、コマンドを連鎖させることができます。 コマンドは、コマンド ラインで指定された順序で実行されます。 コマンドの後 dotnet-debug 終了する場合は、最後のコマンドを exitする必要があります。

• --accept-license-agreement

  確認を求めずにライセンス契約に同意します。

Example

ID 1234 で実行中のプロセスにアタッチします。

$ dotnet-debug attach 1234
Attaching to process: 1234 ...
Ready to process analysis commands. Type 'help' to list available commands or 'help [command]' to get detailed help on a command.
Type 'quit' or 'exit' to exit the session.
>

アタッチ時にコマンドを実行し、終了します。

dotnet-debug attach 1234 -c clrstack -c exit

dotnet-debug open-dump

デバッグ コマンドを使用して対話型シェルを起動し、ダンプ ファイルを探索します。

概要

dotnet-debug open-dump <dump_path> [-c|--commands] [--accept-license-agreement]

論争

• <dump_path>

  分析するダンプ ファイルへのパス。

オプション

• -c|--commands <debug_command>

  起動時にコマンドを実行します。 1 つの呼び出しでこのパラメーターの複数インスタンスを使って、コマンドを連鎖させることができます。 コマンドは、コマンド ラインで指定された順序で実行されます。 コマンドの後 dotnet-debug 終了する場合は、最後のコマンドを exitする必要があります。

• --accept-license-agreement

  確認を求めずにライセンス契約に同意します。

Example

ダンプ ファイルを開いて分析します。

$ dotnet-debug open-dump ./core_20260209_135837
Loading dump: ./core_20260209_135837 ...
Ready to process analysis commands. Type 'help' to list available commands or 'help [command]' to get detailed help on a command.
Type 'quit' or 'exit' to exit the session.
>

SOS コマンドのデバッグ

attachコマンドとopen-dump コマンドの両方で、次の SOS コマンドを受け入れる対話型セッションが表示されます。

dotnet-debugを使用してライブ プロセスにアタッチする

次の例は、実行中の .NET プロセスにアタッチし、スレッド プールの問題を調査する方法を示しています。

$ dotnet-debug attach 1902
Attaching to process: 1902 ...
Ready to process analysis commands. Type 'help' to list available commands or 'help [command]' to get detailed help on a command.
Type 'quit' or 'exit' to exit the session.
>

この操作により、次のようなコマンドを受け取る対話型セッションが開始されます。

> clrstack
OS Thread Id: 0x573d (0)
    Child SP               IP Call Site
00007FFD28B42C58 00007fb22c1a8ed9 [HelperMethodFrame_PROTECTOBJ: 00007ffd28b42c58] System.RuntimeMethodHandle.InvokeMethod(System.Object, System.Object[], System.Signature, Boolean, Boolean)
00007FFD28B42DD0 00007FB1B1334F67 System.Reflection.RuntimeMethodInfo.Invoke(System.Object, System.Reflection.BindingFlags, System.Reflection.Binder, System.Object[], System.Globalization.CultureInfo)
00007FFD28B42E20 00007FB1B18D33ED SymbolTestApp.Program.Foo4(System.String)
00007FFD28B42ED0 00007FB1B18D2FC4 SymbolTestApp.Program.Foo2(Int32, System.String)
00007FFD28B42F00 00007FB1B18D2F5A SymbolTestApp.Program.Foo1(Int32, System.String)
00007FFD28B42F30 00007FB1B18D168E SymbolTestApp.Program.Main(System.String[])

ハンドルされない例外を表示するには:

> pe -lines
Exception object: 00007fb18c038590
Exception type:   System.Reflection.TargetInvocationException
Message:          Exception has been thrown by the target of an invocation.
InnerException:   System.Exception, Use !PrintException 00007FB18C038368 to see more.
StackTrace (generated):
SP               IP               Function
00007FFD28B42DD0 0000000000000000 System.Private.CoreLib.dll!System.RuntimeMethodHandle.InvokeMethod(System.Object, System.Object[], System.Signature, Boolean, Boolean)
00007FFD28B42DD0 00007FB1B1334F67 System.Private.CoreLib.dll!System.Reflection.RuntimeMethodInfo.Invoke(System.Object, System.Reflection.BindingFlags, System.Reflection.Binder, System.Object[], System.Globalization.CultureInfo)+0xa7
00007FFD28B42E20 00007FB1B18D33ED SymbolTestApp.dll!SymbolTestApp.Program.Foo4(System.String)+0x15d

StackTraceString: <none>
HResult: 80131604

dotnet-debug と dotnet-dump

dotnet-debug と dotnet-dump 同じ SOS デバッグ コマンドを共有しますが、主な目的は異なります。

ライブ プロセスを対話形式でデバッグする必要がある場合は、 dotnet-debug を使用します。 ダンプを収集したり、オフラインで分析したりする必要がある場合は、 dotnet-dump を使用します。

こちらも参照ください

• ダンプ収集および分析ユーティリティ (dotnet-dump)
• .NET 用 SOS デバッグ拡張機能
• ヒープ分析ツール (dotnet-gcdump)