데이터소스 다운 또는 장애

증상

다음 둘 중 하나입니다:

플로우 활성화 실패. 작업 관리자에서 플로우의 활성화 토글이 꺼짐으로 되돌아가고, “Could not connect to the datasource” 같은 메시지가 문제를 알려 줍니다.
실행 중인 소스가 스트림 도중 장애를 일으킴. 스트리밍하던 플로우가 예측값 생성을 멈추고 빨간 배너가 나타납니다. 내부적으로 런타임이 장애 상태로 떨어진 뒤 유휴 상태가 됩니다.

어느 단계에서 실패했는지 식별하세요.

메시지를 읽으세요. 메시지는 실패한 단계를 가리킵니다:
- “Could not connect to the datasource” (adapter_connect_failed) → 프로토콜 연결(OPC-UA 핸드셰이크 / MQTT 브로커 연결)이 실패함 — 거의 항상 네트워크나 엔드포인트 문제.
- exactly_N_tags_required → 입력의 태그 매핑이 완전하지 않음.
- 형상 불일치 → 모델이 더 이상 입력의 윈도우 크기와 태그 수, 또는 출력의 태그 수에 맞지 않음.
연결 시도와 장애 원인을 보려면 백엔드 로그를 확인하세요. 플로우의 활성화와 비활성화는 플로우 이름과 함께 기록됩니다:
Terminal window
```
docker logs aiboard-backend-real 2>&1 | grep -iE "flow|datasource|adapter|fault"
```
스트림 도중 장애는 실시간 소스의 읽기 오류(태그 응답 중단)에서 비롯됩니다. 그런 일이 생기면 런타임은 깨끗한 유휴 상태로 분해됩니다: 모델이 언로드되고 어댑터 바인딩이 해제됩니다. 플로우는 여전히 활성화로 표시됩니다. 복구는 자동이 아닙니다 — 플로우를 다시 활성화해야 합니다.

연결 실패 — 런타임이 소스에 도달하지 못했습니다. 활성화가 이미 플로우를 꺼짐으로 깔끔하게 되돌렸으므로, 연결을 수정한 뒤 재시도하세요:
- 데이터소스 구성의 엔드포인트 주소, 포트, 자격 증명을 확인하세요.
- 박스가 OPC-UA 서버 / MQTT 브로커 / 장치에 네트워크로 도달할 수 있는지 확인하세요.
- CSV 소스의 경우 파일 경로와 파일이 존재하고 읽을 수 있는지 확인하세요.
- 폼의 Test Connection을 현재 값으로 실행한 뒤 플로우를 다시 활성화하세요.
불완전한 매핑 — 입력 데이터소스에서 매핑을 열고 모든 채널을 매핑해 저장한 뒤, 플로우를 다시 활성화하세요.
스트림 도중 장애가 난 소스는 유휴 상태로 분해되었습니다 — 모델이 언로드되고 어댑터 바인딩이 해제되었습니다. 완전히 다시 설정하세요:
- 근본적인 소스 문제를 해결하세요(센서 재연결 / 태그 복구 / 네트워크 수정).
- 플로우를 껐다가 다시 켜세요. 모델을 다시 로드하고 어댑터를 재연결합니다.
- Start를 눌러 스트리밍을 재개합니다.

운영에 들어가기 전에 모든 채널을 매핑하세요. 대부분의 활성화 실패는 사전 점검 검증입니다: 불완전한 태그-채널 매핑, 또는 입력에 더 이상 맞지 않는 모델. 매핑을 한 번 완료하면 플로우가 첫 시도에 활성화됩니다.
Start 전에 소스를 안정화하세요. 불안정한 OPC-UA 엔드포인트나 간헐적인 브로커는 스트림에 장애를 일으켜 전체 재활성화를 강제합니다. Start를 누르기 전에 Test Connection으로 안정적인 연결을 확인하세요.
두 단계 흐름을 예상하세요. 활성화는 준비하고, Start는 스트리밍합니다. 이를 운영 절차에 반영하면 “활성화되었는데 아무 일도 일어나지 않는다”는 티켓을 피할 수 있습니다.