입력 데이터소스 연결

🤖 이 번역은 기계 초벌 번역이며 사람 검수 대기 중입니다. 영어 페이지가 기준입니다.

입력 데이터소스는 하나의 논리적 센서 데이터 소스입니다 — OPC-UA 엔드포인트, MQTT 토픽 그룹, CSV 재생 파일 등. 각 소스는 자체 연결 설정과 태그 목록을 가진 유형화된 어댑터입니다. 해당 태그를 모델의 입력 채널에 매핑한 뒤 활성화하여 추론을 시작합니다.

지원되는 입력 소스

• OPC-UA — 호환 서버의 태그를 구독합니다.
• MQTT — 직접 운영하는 브로커, TLS 지원.
• CSV — 파일에서 기록된 데이터를 재생합니다(테스트에 적합).
• PLC — Modbus TCP 및 기타 산업용 프로토콜.

한 번에 하나의 입력만 활성화

어느 순간에도 하나의 입력 데이터소스만 활성화할 수 있습니다. 새 소스를 활성화하면 이전 소스가 자동으로 비활성화됩니다. 이는 런타임을 단일하고 예측 가능한 스트림에 묶어 둡니다.

워크스루: 소스 추가 및 추론 시작

1. 데이터소스 페이지 열기

   대시보드에서 Datasources → Input으로 이동한 뒤 + Create를 클릭합니다.

2. 어댑터 유형 선택 및 연결 정보 입력

   소스 유형을 선택합니다. 폼은 선택한 프로토콜에 맞춰 변경됩니다 — 엔드포인트, 자격 증명, 프로토콜별 필드를 입력하세요. 시크릿 필드(비밀번호, 토큰)는 저장 후 ***로 마스킹됩니다.

   OPC-UA

   필드	예시
   Endpoint	opc.tcp://your-opcua-host:4840/factory/line1
   Security policy	None (또는 인증서를 갖춘 Basic256Sha256 프로필)
   Authentication	Anonymous (또는 사용자 이름/비밀번호)

   태그는 NodeId로 참조됩니다. 예: ns=2;i=2(숫자형) 또는 ns=2;s=Temperature(문자열형).

   MQTT

   필드	예시
   Broker URL	mqtt://your-broker-host:1883 (TLS는 mqtts://)
   Topic	factory/line1/temp
   JSON path	value (메시지에서 숫자 측정값을 추출)
   Username / password	선택 사항 (저장 시 마스킹)

   CSV

   필드	예시
   File	재생할 기록된 데이터셋
   Columns	채널로 공급할 센서 컬럼

   CSV는 재생 전용입니다 — 실제 공장 연결 없이 모델을 테스트하는 데 유용합니다.

3. 태그를 모델 채널에 매핑

   스트리밍할 태그를 나열하고 각각을 번호가 매겨진 입력 채널(0, 1, 2, …)에 할당합니다. 각 채널은 하나의 모델 입력을 공급합니다. 윈도우 크기 — 모델이 예측당 소비하는 연속 샘플 수 — 를 페어링할 모델에 맞게 설정하세요.

   채널 매핑은 완전해야 합니다

   채널당 정확히 하나의 태그를 빠짐없이 제공하세요. 채널이 매핑되지 않았거나 과도하게 채워진 경우 검증에서 활성화가 거부됩니다. 문자열 태그(예: RUN/STOP 상태)는 숫자 피처로 사용할 수 없습니다 — 채널 정의 시 제외하세요.

4. 저장 및 모델 페어링

   데이터소스를 저장합니다. 그런 다음 Models에서 업로드한 모델과 페어링합니다. 플랫폼이 호환성 검사를 실행하며 — 윈도우 크기 × 피처 개수가 양쪽에서 일치해야 하고 — 다르면 페어링을 거부합니다.

5. 활성화 후 시작

   행에서 Enable을 토글합니다. 이는 구성을 검증하고, 페어링된 모델을 로드하며, 어댑터를 연결합니다. 연결 핸드셰이크(OPC-UA / MQTT / Modbus)가 여기서 일어나므로, 네트워크나 자격 증명 문제가 지금 드러나 행을 오류 메시지와 함께 Disabled로 되돌립니다.

   활성화는 스트리밍을 자동으로 시작하지 않습니다 — 추론을 시작하려면 Start를 클릭하세요.

먼저 연결 테스트

활성화 전에 소스에서 Test Connection을 사용하세요. 실시간 폼 값이 엔드포인트에 도달하는지 검증하므로, 태그를 연결하기 전에 잘못된 호스트나 자격 증명을 잡아낼 수 있습니다.

속도 제한 및 버퍼링

각 데이터소스에는 독립적인 속도 제한과 제한된 버퍼가 있습니다. 소스가 런타임이 소비하는 속도보다 빠르게 생성하면, 백프레셔가 대시보드에 보고되어 포화를 알아챌 수 있습니다.

문제가 발생하면

증상	가능한 원인
model_not_paired로 활성화 실패	먼저 데이터소스에 모델을 페어링하세요.
연결 시 활성화가 롤백됨	엔드포인트에 도달할 수 없거나, 자격 증명이 잘못되었거나, 방화벽 문제입니다 — Test Connection으로 확인하세요.
Enabled로 표시되나 예측값 없음	설계상 그렇습니다 — 스트리밍을 시작하려면 Start를 누르세요.
페어링 거부	모델과 데이터소스 간 윈도우 크기 × 피처 개수 불일치.

자세한 내용은 문제 해결 런북을 참조하세요.

다음 단계

결과 내보내기 예측값을 PLC, 브로커, 파일로 라이트백합니다.

모델 배포 모델을 업로드, 페어링, 활성화합니다.