Nsight Graphics CLI スキル は何をしますか？
公式の NVIDIA Nsight Graphics アクティビティをコマンドラインで統括します。
機能
- インストール済みの Nsight バイナリと互換性モードの検出
- アプリケーションを Nsight 配下でデタッチ状態で起動
- 実行中の PID に Nsight をアタッチ
- Graphics Capture または OpenGL フレームデバッガキャプチャのトリガー
- GPU Trace キャプチャのトリガー、自動エクスポート、サマリー生成
- 既存の
.ngfx-captureファイルをngfx-replayで分析 .ngfx-gputrace入力の明確な互換性診断レポート- C++ キャプチャコードの生成
コマンド
doctor
cli-anything-nsight-graphics --json doctor info
cli-anything-nsight-graphics --json doctor versions
cli-anything-nsight-graphics --nsight-path "C:\Path\To\Nsight Graphics 2024.2\host\windows-desktop-nomad-x64" --json doctor info
launch
cli-anything-nsight-graphics launch detached --activity "Graphics Capture" --exe "C:\Path\To\App.exe"
cli-anything-nsight-graphics launch attach --activity "Graphics Capture" --pid 12345
フレームキャプチャ
cli-anything-nsight-graphics --output-dir D:\captures frame capture ^
--exe "C:\Path\To\App.exe" ^
--wait-frames 10
GPU Trace
cli-anything-nsight-graphics --output-dir D:\traces gpu-trace capture ^
--exe "C:\Path\To\App.exe" ^
--start-after-ms 1000 ^
--limit-to-frames 1 ^
--auto-export ^
--summarize
cli-anything-nsight-graphics gpu-trace summarize ^
--input-dir D:\traces
リプレイ分析
cli-anything-nsight-graphics --json replay analyze ^
--capture-file D:\captures\frame.ngfx-capture ^
--output-dir D:\analysis
C++ キャプチャ生成
cli-anything-nsight-graphics --output-dir D:\cpp cpp capture ^
--exe "C:\Path\To\App.exe" ^
--wait-seconds 5
エージェント向け注意事項
- 最初に
doctor infoを使用して、利用可能な互換性モードを確認することを推奨します。 - 複数の Nsight Graphics バージョンが存在する場合は、
doctor versionsを使用して検出されたインストールを一覧表示します。 --nsight-pathを使用して、特定のインストールディレクトリまたはngfx.exeを強制的に指定します。- プログラムによるワークフローには
--jsonを使用します。 - ワンステップのパフォーマンストリアージには、
gpu-trace capture --auto-export --summarizeを推奨します。サマリーには、エクスポートされたテーブル一覧、メトリクス一覧、フレームバジェット分類、ワークロード分類、スループットランキング、ボトルネックヒント、空のイベント/レジームテーブルに対する警告が含まれます。 - 入力が既存の
.ngfx-captureファイルの場合は、replay analyzeを使用します。分析スイッチを指定しない場合、メタデータ、ログ、キャプチャされたログエラー、リプレイパフォーマンスレポートがエクスポートされ、構造化されたanalysis.highlights/analysis.warningsが追加されます。 ngfx-replayは入力を Graphics Capture ファイルとして文書化しています。.ngfx-gputrace入力は明確な診断のために受け入れられますが、Nsight Graphics 2026.1.0 ではInvalid file headerと報告される可能性があります。その場合はgpu-trace summarizeを使用して、エクスポートされた GPU Trace テーブルを分析してください。replay analyzeは公式のngfx-replayメタデータ/ログ/スクリーンショット/パフォーマンスレポート出力を使用します。RenderDoc スタイルのシェーダー、パイプライン、テクスチャ、リソースインスペクタではありません。- フレーム/GPU/C++ キャプチャコマンドは、
--exeで起動ターゲットを指定するか、事前に設定されたルートレベルの--projectが必要です。 - グローバルな
cli-anything-nsight-graphicsコマンドが古いワークツリーを指している場合は、nsight-graphics/agent-harnessからpython -m pip install -e .で再インストールしてください。