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-Catalog.xlsx 분석을 통해 총 172개의 XID 코드를 지원합니다.

XID	이름	심각도	설명
1	ROBUST_CHANNEL_FIFO_ERROR_FIFO_METHOD	심각	Unused
2	ROBUST_CHANNEL_FIFO_ERROR_SW_METHOD	심각	Unused
3	ROBUST_CHANNEL_FIFO_ERROR_UNK_METHOD	심각	Unused
4	ROBUST_CHANNEL_FIFO_ERROR_CHANNEL_BUSY	심각	Unused
5	ROBUST_CHANNEL_FIFO_ERROR_RUNOUT_OVERFLOW	심각	Unused
6	ROBUST_CHANNEL_FIFO_ERROR_PARSE_ERR	심각	Unused
7	ROBUST_CHANNEL_FIFO_ERROR_PTE_ERR	심각	Unused
8	GPU Stopped Responding	심각	GPU가 응답을 중단했습니다. 하드웨어 결함 또는 드라이버 문제일 수 있습니다.
9	ROBUST_CHANNEL_GR_ERROR_INSTANCE	심각	Unused
10	ROBUST_CHANNEL_GR_ERROR_SINGLE_STEP	심각	Unused
11	ROBUST_CHANNEL_GR_ERROR_MISSING_HW	경고	Invalid or corrupted push buffer stream
12	ROBUST_CHANNEL_GR_ERROR_SW_METHOD	심각	Unused
13	Graphics Engine Exception	심각	그래픽 엔진에서 예외가 발생했습니다. GPU 코어 또는 메모리 결함 가능성.
14	ROBUST_CHANNEL_FAKE_ERROR	정보	Unused
15	ROBUST_CHANNEL_SCANLINE_TIMEOUT	심각	Unused
16	ROBUST_CHANNEL_VBLANK_CALLBACK_TIMEOUT	심각	Unused
17	ROBUST_CHANNEL_PARAMETER_ERROR	심각	Unused
18	ROBUST_CHANNEL_BUS_MASTER_TIMEOUT_ERROR	심각	Unused
19	ROBUST_CHANNEL_DISP_MISSED_NOTIFIER	심각	Unused
20	ROBUST_CHANNEL_MPEG_ERROR_SW_METHOD	심각	Unused
21	ROBUST_CHANNEL_ME_ERROR_SW_METHOD	심각	Unused
22	ROBUST_CHANNEL_VP_ERROR_SW_METHOD	심각	Unused
23	ROBUST_CHANNEL_RC_LOGGING_ENABLED	심각	Unused
24	ROBUST_CHANNEL_GR_SEMAPHORE_TIMEOUT	심각	Unused
25	ROBUST_CHANNEL_GR_ILLEGAL_NOTIFY	경고	Invalid or illegal push buffer stream
26	ROBUST_CHANNEL_FIFO_ERROR_FBISTATE_TIMEOUT	심각	Unused
27	ROBUST_CHANNEL_VP_ERROR	심각	Unused
28	ROBUST_CHANNEL_VP2_ERROR	심각	Unused
29	ROBUST_CHANNEL_BSP_ERROR	심각	Unused
30	ROBUST_CHANNEL_BAD_ADDR_ACCESS	심각	Unused
31	GPU Memory Page Fault	심각	GPU 메모리 페이지 폴트. 메모리 손상 또는 드라이버 버그 가능성.
32	Invalid or Corrupted Push Buffer	경고	손상된 푸시 버퍼 감지. 드라이버 또는 애플리케이션 문제.
33	ROBUST_CHANNEL_SEC_ERROR	심각	Unused
34	ROBUST_CHANNEL_MSVLD_ERROR	심각	Unused
35	ROBUST_CHANNEL_MSPDEC_ERROR	심각	Unused
36	ROBUST_CHANNEL_MSPPP_ERROR	심각	Unused
37	ROBUST_CHANNEL_FECS_ERR_UNIMP_FIRMWARE_METHOD	정보	Driver firmware error
38	Driver Firmware Mismatch	경고	드라이버와 펌웨어 버전 불일치.
39	ROBUST_CHANNEL_CE0_ERROR	경고	Copy Engine Exception
40	ROBUST_CHANNEL_CE1_ERROR	경고	Copy Engine Exception
41	ROBUST_CHANNEL_CE2_ERROR	경고	Copy Engine Exception
42	ROBUST_CHANNEL_VIC_ERROR	심각	Unused
43	GPU Stopped Processing	심각	GPU 처리가 중단됨. 심각한 하드웨어 또는 드라이버 문제.
44	ROBUST_CHANNEL_GR_FAULT_DURING_CTXSW	정보	Graphics Engine fault during context switch
45	GPU Preemption Failure	경고	GPU 선점 실패. 특정 워크로드에서 타임아웃 발생.
46	ROBUST_CHANNEL_GPU_TIMEOUT_ERROR	정보	GPU stopped processing
47	ROBUST_CHANNEL_NVENC0_ERROR	심각	Unused
48	Double Bit ECC Error	심각	수정 불가능한 Double Bit ECC 에러 발생. GPU 메모리 물리적 손상.
49	SILENT_RUNNING_CONSTANT_LEVEL_SET_BY_REGISTRY	심각	Unused
50	SILENT_RUNNING_LEVEL_TRANSITION_DUE_TO_RC_ERROR	심각	Unused
51	SILENT_RUNNING_STRESS_TEST_FAILURE	심각	Unused
52	SILENT_RUNNING_LEVEL_TRANS_DUE_TO_TEMP_RISE	심각	Unused
53	SILENT_RUNNING_TEMP_REDUCED_CLOCKING	심각	Unused
54	SILENT_RUNNING_PWR_REDUCED_CLOCKING	경고	Auxiliary power is not connected to the GPU board
55	SILENT_RUNNING_TEMPERATURE_READ_ERROR	심각	Unused
56	DISPLAY_CHANNEL_EXCEPTION	심각	Unused
57	FB_LINK_TRAINING_FAILURE_ERROR	심각	Unused
58	FB_MEMORY_ERROR	심각	Unused
59	PMU_ERROR	심각	Unused
60	ROBUST_CHANNEL_SEC2_ERROR	경고	Video processor exception
61	GPU Fallen Off the Bus	심각	GPU가 PCIe 버스에서 분리됨. 전원 또는 물리적 연결 문제.
62	GPU ECC Page Retirement	경고	ECC 에러로 인한 메모리 페이지 은퇴 처리.
63	ECC Page Retirement: Double Bit	심각	Double Bit ECC 에러로 인한 페이지 은퇴. 심각한 메모리 손상.
64	ECC Page Retirement Failure	심각	ECC 에러 페이지 은퇴 실패. 더 이상 은퇴할 수 있는 페이지가 없음.
65	ROBUST_CHANNEL_NVENC1_ERROR	심각	Unused
66	ROBUST_CHANNEL_FECS_ERR_REG_ACCESS_VIOLATION	정보	Illegal access by driver
67	ROBUST_CHANNEL_FECS_ERR_VERIF_VIOLATION	정보	Illegal access by driver
68	ROBUST_CHANNEL_NVDEC0_ERROR	경고	NVDEC0 Exception
69	GPU Access to System Memory Failed	경고	GPU에서 시스템 메모리 접근 실패. IOMMU 또는 드라이버 문제.
70	ROBUST_CHANNEL_CE3_ERROR	경고	CE3: Unknown Error
71	ROBUST_CHANNEL_CE4_ERROR	경고	CE4: Unknown Error
72	ROBUST_CHANNEL_CE5_ERROR	경고	CE5: Unknown Error
73	ROBUST_CHANNEL_NVENC2_ERROR	심각	Unused
74	NVLINK_ERROR	정보	NVLINK Error
75	ROBUST_CHANNEL_CE6_ERROR	경고	CE6: Unknown Error
76	ROBUST_CHANNEL_CE7_ERROR	경고	CE7: Unknown Error
77	ROBUST_CHANNEL_CE8_ERROR	경고	CE8: Unknown Error
78	VGPU_START_ERROR	경고	vGPU Start Error
79	GPU Fallen Off the Bus (Fatal)	심각	GPU가 PCIe 버스에서 완전히 분리됨. Xid 61의 치명적 버전.
80	PBDMA_PUSHBUFFER_CRC_MISMATCH	경고	Corrupted data sent to GPU
81	ROBUST_CHANNEL_VGA_SUBSYSTEM_ERROR	심각	Unused
82	ROBUST_CHANNEL_NVJPG0_ERROR	경고	NVJPG0 Error
83	ROBUST_CHANNEL_NVDEC1_ERROR	경고	NVDEC1 Error
84	ROBUST_CHANNEL_NVDEC2_ERROR	경고	NVDEC2 Error
85	ROBUST_CHANNEL_CE9_ERROR	경고	CE9: Unknown Error
86	ROBUST_CHANNEL_OFA0_ERROR	경고	OFA Exception
87	NVTELEMETRY_DRIVER_REPORT	심각	Unused
88	ROBUST_CHANNEL_NVDEC3_ERROR	경고	NVDEC3 Error
89	ROBUST_CHANNEL_NVDEC4_ERROR	경고	NVDEC4 Error
90	LTC_ERROR	심각	Unused
91	RESERVED_XID	심각	Unused
92	High Single-bit ECC Error Rate	경고	단일 비트 ECC 에러 빈도가 높음. 메모리 노후화 징후.
93	INFOROM_ERASE_LIMIT_EXCEEDED	정보	Non-fatal violation of provisioned InfoROM wear limit
94	Contained ECC Error	정보	격리된 ECC 에러. 자동으로 수정되었으나 모니터링 필요.
95	Uncontained ECC Error	심각	격리되지 않은 ECC 에러. 데이터 손상 가능성.
96	ROBUST_CHANNEL_NVDEC5_ERROR	경고	NVDEC5 Error
97	ROBUST_CHANNEL_NVDEC6_ERROR	경고	NVDEC6 Error
98	ROBUST_CHANNEL_NVDEC7_ERROR	경고	NVDEC7 Error
99	ROBUST_CHANNEL_NVJPG1_ERROR	경고	NVJPG1 Error
100	ROBUST_CHANNEL_NVJPG2_ERROR	경고	NVJPG2 Error
101	ROBUST_CHANNEL_NVJPG3_ERROR	경고	NVJPG3 Error
102	ROBUST_CHANNEL_NVJPG4_ERROR	경고	NVJPG4 Error
103	ROBUST_CHANNEL_NVJPG5_ERROR	경고	NVJPG5 Error
104	ROBUST_CHANNEL_NVJPG6_ERROR	경고	NVJPG6 Error
105	ROBUST_CHANNEL_NVJPG7_ERROR	경고	NVJPG7 Error
106	SMBPBI_TEST_MESSAGE	정보	SMBPBI Test Message
107	SMBPBI_TEST_MESSAGE_SILENT	정보	SMBPBI Test Message Silent
108	NVLINK_REMOTE_TRANSLATION_ERROR	정보	Unused
109	ROBUST_CHANNEL_CTXSW_TIMEOUT_ERROR	정보	Context Switch Timeout Error
110	SEC_FAULT_ERROR	정보	Security Fault Error
111	BUNDLE_ERROR_EVENT	심각	Unused
112	DISP_SUPERVISOR_ERROR	심각	Unused
113	DP_LT_FAILURE	심각	Unused
114	HEAD_RG_UNDERFLOW	심각	Unused
115	CORE_CHANNEL_REGS	심각	Unused
116	WINDOW_CHANNEL_REGS	심각	Unused
117	CURSOR_CHANNEL_REGS	심각	Unused
118	HEAD_REGS	심각	Unused
119	GPU Recovery Action	정보	GPU 복구 작업 수행됨. 일시적 에러에서 자동 복구.
120	GSP_ERROR	정보	GSP Error
121	C2C_ERROR	정보	C2C Error
122	SPI_PMU_RPC_READ_FAIL	심각	Unused
123	SPI_PMU_RPC_WRITE_FAIL	심각	Unused
124	SPI_PMU_RPC_ERASE_FAIL	심각	Unused
125	INFOROM_FS_ERROR	심각	Unused
126	ROBUST_CHANNEL_CE10_ERROR	경고	CE10: Unknown Error
127	ROBUST_CHANNEL_CE11_ERROR	경고	CE11: Unknown Error
128	ROBUST_CHANNEL_CE12_ERROR	경고	CE12: Unknown Error
129	ROBUST_CHANNEL_CE13_ERROR	경고	CE13: Unknown Error
130	ROBUST_CHANNEL_CE14_ERROR	경고	CE14: Unknown Error
131	ROBUST_CHANNEL_CE15_ERROR	경고	CE15: Unknown Error
132	ROBUST_CHANNEL_CE16_ERROR	경고	CE16: Unknown Error
133	ROBUST_CHANNEL_CE17_ERROR	경고	CE17: Unknown Error
134	ROBUST_CHANNEL_CE18_ERROR	경고	CE18: Unknown Error
135	ROBUST_CHANNEL_CE19_ERROR	경고	CE19: Unknown Error
136	ALI_TRAINING_FAIL	정보	Link Training Failed
137	NVLINK_PRIV_ERR	정보	NVLink Privilege Error
138	ROBUST_CHANNEL_DLA_ERROR	심각	Unused
139	ROBUST_CHANNEL_OFA1_ERROR	경고	OFA1 Error
140	UNRECOVERABLE_ECC_ERROR_ESCAPE	정보	ECC Unrecovered Error
141	ROBUST_CHANNEL_FAST_PATH_ERROR	정보	CUDA Fast Path Error
142	ROBUST_CHANNEL_NVENC3_ERROR	심각	NVENC3 Error
143	GPU_INIT_ERROR	정보	GPU Initialization Error
144	NVLINK_SAW_ERROR	정보	NVLINK: SAW Error
145	NVLINK_RLW_ERROR	정보	NVLINK: RLW Error
146	NVLINK_TLW_ERROR	정보	NVLINK: TLW Error
147	NVLINK_TREX_ERROR	정보	NVLINK: TREX Error
148	NVLINK_NVLPW_CTRL_ERROR	정보	NVLINK: NVLPW_CTRL Error
149	NVLINK_NETIR_ERROR	정보	NVLINK: NETIR Error
150	NVLINK_MSE_ERROR	정보	NVLINK: MSE Error
151	ROBUST_CHANNEL_KEY_ROTATION_ERROR	경고	Key rotation Error
152	ROBUST_CHANNEL_DLA_SMMU_ERROR	정보	DLA SMMU Error
153	ROBUST_CHANNEL_DLA_TIMEOUT	정보	DLA timeout Error
154	GPU_RECOVERY_ACTION_CHANGED	정보	GPU Recovery Action Changed
155	NVLINK_SW_DEFINED_ERROR	정보	NVLINK: SW Defined Error
156	RESOURCE_RETIREMENT_EVENT	정보	Resource Retirement Event
157	RESOURCE_RETIREMENT_FAILURE	정보	Resource Retirement Failure
158	GPU_FATAL_TIMEOUT	정보	GPU Fatal Timeout
159	ROBUST_CHANNEL_CHI_NON_DATA_ERROR	경고	CHI Non-Data Error
160	CHANNEL_RETIREMENT_EVENT	정보	Channel Retirement Event
161	CHANNEL_RETIREMENT_FAILURE	정보	Channel Retirement Failure
162	PSHC_REENGAGED	정보	Power Smoothing HW Circuitry capability reengaged
163	PSHC_DISENGAGED	정보	Power Smoothing HW Circuitry capability disengaged
164	PSHC_LOW_LIFETIME	정보	Power Smoothing HW Circuitry low lifetime reached
165	PSHC_ZERO_LIFETIME	정보	Power Smoothing HW Circuitry lifetime exhausted
166	NVLINK_SECURE_CRYPTO_ERR	정보	CC traffic seen prior to link properly being configured for encrypted traffic
167	PCIE_FATAL_TIMEOUT	정보	PCIE_FATAL_TIMEOUT
168	REDUCED_GPU_MEMORY_CAPACITY	정보	Errors found in WPR (write protected region)
169	SEC2_HALT_ERROR	정보	Internal micro-controller halt
170	NVLINK_SECURE_OTHER	정보	Interrupt seen in CC mode
171	UNCORRECTABLE_DRAM_ERROR	정보	Additional to Xid 48 providing more details on particulars of fault to differentiate DRAM/SRAM
172	UNCORRECTABLE_SRAM_ERROR	정보	Additional to Xid 48 providing more details on particulars of fault to differentiate DRAM/SRAM