문제 해결

표에서 증상을 찾아 해결 방법으로 바로 이동하세요. 모든 런북 페이지는 동일한 구조를 따릅니다: 증상 → 확인 → 해결 → 예방.

증상 찾기

다음과 같은 현상이 보이면…	이동
GPU가 설치되어 있으나 추론이 CPU에서 실행됨; 로그에 `CUDA failure 500: named symbol not found` 표시	GPU 미사용 — CUDA 오류 500
GPU 강제 적용 시 호스트 GPU가 손상되어 추론 컨테이너가 종료/재시작됨	GPU 미사용 — CUDA 오류 500
호스트 GPU는 동작하나 공급자가 예상보다 낮은 등급으로 표시됨 (예: TensorRT 대신 CUDA, 또는 CPU)	GPU 예상 시 CPU에서 실행됨
로그 줄 `Failed to load library libonnxruntime_providers_tensorrt.so`	GPU 예상 시 CPU에서 실행됨
데이터소스 활성화가 `model_not_paired` 또는 `adapter_connect_failed`와 함께 다시 비활성화로 되돌아감	데이터소스 중단 또는 결함
스트리밍 OPC-UA / MQTT / CSV 소스가 멈춤; 행에 결함 표시기 / 빨간 배너가 나타남	데이터소스 중단 또는 결함
데이터소스가 활성화되었으나 예측값이 나타나지 않음	데이터소스 중단 또는 결함
MQTT 입력이 토픽이 조용해진 뒤 장애가 발생하거나, 로그에 `tag stale` / `ChannelReadException`이 표시됨	MQTT 입력 중지 또는 결함
모든 예측값이 `NaN`으로 나오거나, 토픽이 `NaN`/`Infinity` 센티널을 발행함	MQTT 입력 중지 또는 결함
MQTT 싱크 로그에 `transport: not connected`가 표시되거나, 로그에 `SessionTakenOver`가 표시됨	MQTT 입력 중지 또는 결함
태그 매핑이 `tag_outside_subscription_*`와 함께 거부됨	MQTT 입력 중지 또는 결함
설정 → 정보에서 프런트엔드 / 백엔드 버전이 호박색으로 강조됨	프런트엔드 / 백엔드 버전 불일치
버전이 `0.0.0-dev…`로 표시되거나 `-dirty`로 끝남	프런트엔드 / 백엔드 버전 불일치
디스크가 가득 참; 데이터베이스 파일이 보유 데이터보다 훨씬 큼; 행을 삭제해도 줄어들지 않음	디스크 가득 참 / 데이터베이스 무한 증가
`docker ps`에서 컨테이너가 `unhealthy`로 표시되나 앱은 정상 동작함	컨테이너가 unhealthy로 표시되나 서비스는 정상