Alpha 版 VS Code 拡張機能で公開されているプロファイラーワークフロー。

プロファイラー

SharpLsp は .NET 診断ワークフローを VS Code に統合します。拡張機能は、プロセス検出、トレース、カウンター、ダンプ、ヒープ解析、関連ファイル操作のコマンドを公開します。プロファイラー体験は beta に向けて強化中です。

前提条件

.NET 診断ツールをグローバルにインストールします。

dotnet tool install -g dotnet-trace
dotnet tool install -g dotnet-counters
dotnet tool install -g dotnet-dump

SharpLsp は PATH と dotnet tool list -g からこれらのツールを自動検出します。ツールが見つからない場合、コマンドはインストールコマンドを含む実行可能なエラーを返します。

プロファイラーツリービュー

SharpLsp サイドバーの Profiler パネルには次が表示されます。

Refresh をクリックするとプロセス一覧が更新されます。ステータスバーにはアクティブなプロファイルセッション数が表示されます。

パフォーマンストレース（dotnet-trace）

詳細なパフォーマンストレースを取得し、SpeedScope で表示します。

トレースを開始する

1. SharpLsp サイドバーで Profiler ビューを開きます
2. コマンドパレットから SharpLsp: Start Trace を実行します
3. ピッカーから .NET プロセスを選びます
4. トレースセッションがツリービューに表示されます

トレースを停止する

1. コマンドパレットから SharpLsp: Stop Trace を実行します
2. アクティブなトレースセッションを選びます
3. SharpLsp が .nettrace を SpeedScope 形式へ変換し、ブラウザーで自動的に開きます

設定

# sharplsp.toml
[profiler]
default_profile = "cpu-sampling"   # cpu-sampling | gc-verbose | gc-collect | none
default_format = "speedscope"      # speedscope | nettrace | chromium
default_duration = 0               # 秒。0 = 手動停止
max_sessions = 5

ライブカウンター監視（dotnet-counters）

リアルタイム更新されるテーブルで .NET パフォーマンスカウンターを監視します。

監視を開始する

1. コマンドパレットから SharpLsp: Start Counters を実行します
2. .NET プロセスを選びます
3. ライブカウンター値を表示する webview パネルが開きます

カウンター表示

カウンターは sharplsp/profiler/counterUpdate LSP 通知でストリーミングされます。SharpLsp: Stop Counters を実行するとセッションが終了します。

メモリダンプ（dotnet-dump）

メモリリークや高メモリ使用量を調べるため、メモリダンプを取得して解析します。

ダンプを収集する

1. コマンドパレットから SharpLsp: Collect Dump を実行します
2. .NET プロセスを選びます
3. ダンプ種別を選びます: Heap、Full、Mini
4. SharpLsp が出力パスとファイルサイズを報告します

ヒープを解析する

1. コマンドパレットから SharpLsp: Analyze Heap を実行します
2. .dmp ファイルを選びます
3. SharpLsp が dumpheap -stat を実行し、整形されたテーブルを表示します

ヒープスナップショットの差分

2 つのヒープダンプを比較して、増加している型やメモリリークを特定します。

スナップショットを比較する

1. コマンドパレットから SharpLsp: Compare Heap Snapshots を実行します
2. baseline ダンプファイルを選びます（疑わしいリーク経路を実行する前）
3. comparison ダンプファイルを選びます（実行後）
4. 差分パネルが開き、次を表示します

任意の行をクリックすると、comparison ダンプ内のその型に対する Object Retention Graph が開きます。

リーク候補テーブル

完全な差分の上に、SharpLsp は重大度で自動分類した leak suspects を表示します。

リークしやすい既知の型（EventHandler、CancellationTokenSource、Timer、delegate）は最低でも Low へ引き上げられます。増加するコレクション（List、Dictionary、配列）は、上限のない蓄積の可能性としてフラグ付けされます。

自動リーク検出

baseline → exercise → compare のガイド付きワークフローを自動実行します。

1. SharpLsp: Detect Memory Leaks を実行します
2. .NET プロセスを選びます。SharpLsp が baseline ダンプを収集します
3. アプリケーションで疑わしいリーク経路を実行します
4. SharpLsp が comparison ダンプを収集し、完全なヒープ差分を自動実行します
5. 差分パネルが開き、候補が強調表示されます

Object Retention Graph

ダンプ内で生存しているオブジェクトと、それをメモリ上に保持しているものを可視化します。

グラフを開く

1. コマンドパレットから SharpLsp: Show Object Retention Graph を実行します
2. .dmp ファイルを選びます
3. ルートオブジェクトアドレスを入力します（16 進数、例: 00007ff812345678）
4. 対話型の force-directed graph が webview パネルに描画されます

または、Heap Diff パネルの任意の行をクリックすると、comparison ダンプをプリロードした状態でグラフが開きます。

グラフ操作

ノード色

破線枠 = GC root。破線エッジ = weak reference。

オブジェクト調査

1. コマンドパレットから SharpLsp: Inspect Object を実行します
2. .dmp ファイルを選び、オブジェクトアドレスを入力します
3. テキストパネルに、オブジェクトの型、サイズ、世代、参照アドレス付きの全フィールド値が表示されます

コマンド

パフォーマンス目標