Files
nvidia-bug/README.md
T

2.3 KiB

NV-Log Analyzer

NVIDIA Bug Report 로그 자가 진단 서비스

nvidia-bug-report.log.gz 파일을 업로드하면 XID 에러, GPU 상태, 커널 로그를 자동 분석하여 권장 조치를 안내합니다.

주요 기능

  • XID 에러 탐지: NVRM: Xid 패턴 자동 검출 + 에러 코드별 한글 권장 조치 제공
  • GPU 헬스 체크: 온도, 전력, ECC 에러, 메모리 상태 요약
  • 커널 로그 필터링: dmesg 내 Critical, Error, OOM, PCIe 에러 추출
  • 원본 로그 검색: 키워드 기반 로그 검색 기능
  • XID 코드 조회: 사이드바에서 XID 번호로 즉시 의미 확인

빠른 시작

방법 1: 로컬 실행

pip install -r requirements.txt
streamlit run app.py

브라우저에서 http://localhost:8501 접속

방법 2: Docker

docker-compose up -d

브라우저에서 http://localhost:8501 접속

프로젝트 구조

nvidia/
├── app.py                 # Streamlit 대시보드 (메인 UI)
├── log_parser.py          # 핵심 분석 엔진
├── data/
│   └── xid_database.json  # XID 에러 코드 매핑 DB (18종)
├── requirements.txt
├── Dockerfile
├── docker-compose.yml
└── README.md

분석 대상 로그 생성 방법

GPU 서버에서 아래 명령 실행:

sudo nvidia-bug-report.sh

생성된 nvidia-bug-report.log.gz 파일을 웹 대시보드에 업로드하면 됩니다.

지원하는 XID 코드

XID 이름 심각도
8 GPU Stopped Responding 심각
13 Graphics Engine Exception 심각
31 GPU Memory Page Fault 심각
32 Invalid Push Buffer 경고
38 Driver Firmware Mismatch 경고
43 GPU Stopped Processing 심각
45 GPU Preemption Failure 경고
48 Double Bit ECC Error 심각
61 GPU Fallen Off the Bus 심각
62 GPU ECC Page Retirement 경고
63 ECC Page Retirement: Double Bit 심각
64 ECC Page Retirement Failure 심각
69 GPU Access to System Memory Failed 경고
79 GPU Fallen Off the Bus (Fatal) 심각
92 High Single-bit ECC Error Rate 경고
94 Contained ECC Error 정보
95 Uncontained ECC Error 심각
119 GPU Recovery Action 정보