unknown
80 lines
2.3 KiB
Markdown
80 lines
2.3 KiB
Markdown
# 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: 로컬 실행
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
streamlit run app.py
|
|
```
|
|
|
|
브라우저에서 `http://localhost:8501` 접속
|
|
|
|
### 방법 2: Docker
|
|
|
|
```bash
|
|
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 서버에서 아래 명령 실행:
|
|
|
|
```bash
|
|
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 | 정보 |
|