Nsight Graphics CLI 스킬
공식 NVIDIA Nsight Graphics 활동의 명령줄 오케스트레이션입니다.
기능
- 설치된 Nsight 바이너리 및 호환성 모드 검색
- Nsight 하에서 애플리케이션을 분리 실행
- 실행 중인 PID에 Nsight 연결
- 그래픽 캡처 또는 OpenGL 프레임 디버거 캡처 트리거
- GPU 트레이스 캡처, 자동 내보내기 및 요약 트리거
ngfx-replay를 통한 기존.ngfx-capture파일 분석.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 트레이스
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를 사용하여 감지된 설치 목록을 확인하세요. - 특정 설치 디렉토리 또는
ngfx.exe를 강제로 지정하려면--nsight-path를 사용하세요. - 프로그래밍 방식 워크플로우에는
--json을 사용하세요. - 단일 단계 성능 문제 분석을 위해
gpu-trace capture --auto-export --summarize를 선호하세요. 요약에는 내보낸 테이블 인벤토리, 메트릭 인벤토리, 프레임 예산 분류, 워크로드 분류, 처리량 순위, 병목 힌트, 빈 이벤트/레짐 테이블에 대한 경고가 포함됩니다. - 입력이 기존
.ngfx-capture파일인 경우replay analyze를 사용하세요. 분석 스위치 없이 실행하면 메타데이터, 로그, 캡처된 로그 오류, 리플레이 성능 보고서를 내보내고 구조화된analysis.highlights/analysis.warnings를 추가합니다. ngfx-replay는 입력이 그래픽 캡처 파일이라고 문서화합니다..ngfx-gputrace입력은 명확한 진단을 위해 허용되지만, Nsight Graphics 2026.1.0에서는Invalid file header를 보고할 수 있습니다. 내보낸 GPU 트레이스 테이블 분석에는gpu-trace summarize를 사용하세요.replay analyze는 공식ngfx-replay메타데이터/로그/스크린샷/성능 보고서 출력을 사용합니다. RenderDoc 스타일의 셰이더, 파이프라인, 텍스처 또는 리소스 인스펙터가 아닙니다.- 프레임/GPU/C++ 캡처 명령은
--exe를 통한 실행 대상 또는 사전 구성된 루트 수준--project가 필요합니다. - 전역
cli-anything-nsight-graphics명령이 이전 작업 트리를 가리키는 경우nsight-graphics/agent-harness에서python -m pip install -e .로 재설치하세요.