실시간 값 보기
등록한 PLC / 태그의 현재 값 을 실시간으로 확인하는 방법입니다. 게이트웨이에는 세 가지 라이브 뷰가 있습니다.
| 뷰 | 폴링 주기 | 용도 |
|---|---|---|
/ui/connect/list (좌측 OPC + 우측 태그 표) | 5 초 | 한 OPC 의 모든 태그 값을 한눈에 |
/ui/connect/tag-view/{opc_id}/{tag_id} (단일 태그 라이브 차트) | 1 초 | 특정 태그의 추세 와 시계열 |
/ui/main 카드 | 1 초 | 게이트웨이 시스템 상태 (CPU/메모리/네트워크/Sparkplug 등) |
1. [연결 목록] 화면에서 보기 (/ui/connect/list)
가장 간단한 방법입니다.
- 좌측 사이드바 연결된 목록 아이콘 또는 메인 카드 연결된 목록 (N) 클릭
- 좌측 [OPC 목록] 에서 보고 싶은 PLC 행 클릭
- 우측에 그 PLC 의 태그 목록 + 현재 값이 표시됩니다.
- 5 초마다 자동 새로고침 됩니다.
상세 컬럼 / 액션은 연결 목록 / 태그 목록 화면 참고.
2. 단일 태그 라이브 차트 (/ui/connect/tag-view/{opc_id}/{tag_id})
특정 태그의 시계열을 본격적으로 보고 싶으면 태그 행 클릭 → 별도 tag-view 페이지로 이동합니다 (또는 직접 URL 진입).
2.1 화면 구성
┌────────────────────────────────────────────────────────────┐
│ ⊙ {OPC_ID} / {TAG_ID} [←] [↻] │
├────────────────────────────────────────────────────────────┤
│ [태그 메타 패널] │
│ tag_id / java_type / plc_address / opc_id / 마지막 갱신 │
├────────────────────────────────────────────────────────────┤
│ [값 추이 차트] [범위 콤보 ▼] │
│ ┌──────────────────────────────────────────────────────┐ │
│ │ (수치/불리언 — ECharts 라인 / STRING — vis 박스) │ │
│ │ │ │
│ │ [── dataZoom 슬라이더 (연한 그레이) ────────] │ │
│ └──────────────────────────────────────────────────────┘ │
└────────────────────────────────────────────────────────────┘
2.2 차트 종류 (자동 분기)
| 데이터 타입 | 차트 |
|---|---|
Integer / Long / Float / Double | ECharts 라인 — 부드러운 스플라인 + 우측 Y축 |
Boolean | ECharts step end — 0/1 계단형 |
String | vis-timeline 박스 — 같은 값 연속 구간을 한 박스로 묶음 (상태 머신 시각화) |
2.3 차트 인터랙션
| 기능 | 설명 |
|---|---|
| 범위 콤보 | 1분 / 5분 / 10분 / 30분 / 1시간(default) / 3시간 / 12시간 / 24시간 — 선택 시 Cassandra tm_tag_point 에서 즉시 다시 fetch |
| dataZoom 슬라이더 | 차트 하단 가로 막대 — 마우스 드래그로 가로 zoom / pan. 연한 그레이 톤 (이전 진한 색에서 변경) — 차트 본문을 가리지 않음 |
| 자동 추가 | 1 초 폴링이 새 값을 차트에 push (전체 redraw 없이 incremental 추가) |
| 마우스 hover | tooltip 으로 ms 단위 시각 + 값 |
| STRING 차트 갱신 | history 를 ASC 정렬 후 vis dataset 전체 재구성 — 같은 값 연속 구간이면 깜빡임 없음 |
OPC-UA 노드 뷰어 의 우측 차트와 동일 톤 / 동일 데이터를 사용합니다 — 단, tag-view 는 한 태그만 풀 화면, opcua viewer 는 트리 + 작은 차트 패널.
3. 표 컬럼 (참고)
좌측 [OPC 목록]
| 컬럼 | 의미 |
|---|---|
| PLC | 프로토콜 | 프로토콜 별 로고 + 종류 |
| 연결 상태 | 🟢 연결 / 🔴 끊김 / ⬜ 알수없음 |
| OPC ID / 명 / 설명 | 식별 / 사용자 라벨 |
| 수집 주기 (ms) | timecycle |
| 자동 시작 / 비동기 | 옵션 ✓ / - |
| 연결된 태그수 | 그 OPC 의 태그 개수 |
| 수집 건수 | 부팅 후 누적 read 수 (point_count) |
| 수집 상태 | 🟢 정상 / 🟧 이상 / ⬜ 중지 |
| 액션 | ▶ 시작 / ⏹ 중지 / 🔧 편집 / 🗑 삭제 |
(자세한 14 컬럼 원본은 연결 목록)
우측 [태그 목록]
| 컬럼 | 의미 |
|---|---|
| TAG ID / 명 | 식별 / 사용자 라벨 |
| PLC 주소 | 어디에서 읽는지 (예: D0, M10, 40001) |
| 데이터 타입 | INT / DOUBLE / BOOL / STRING ... |
| 마지막 값 | 가장 최근 수집 (라운드 솔리드 뱃지 — pp-cell-pill 톤. 컬럼 폭 160px) |
| 업데이트 시간 | 마지막 갱신 시각 |
| 읽기 상태 | OK (녹색 솔리드) / ERROR (빨강 솔리드) |
| 읽기 에러 메세지 | 실패 사유 (성공 시 비어있음) |
| 액션 | ✏ 인라인 쓰기 / 📈 차트 (tag-view 로 이동) |
메인 화면의 한눈 보기
상단 [홈] (또는 좌측 상단 로고 클릭) 으로 돌아오면 게이트웨이 전체 상태를 한 화면에서 볼 수 있습니다.
| 표시 영역 | 보여주는 것 |
|---|---|
| CPU / 메모리 / 디스크 게이지 | 게이트웨이 PC 자원 상태 |
| 연결 / 태그 건수 | 전체 등록 건수 요약 |
| PLC 연결 및 수집 상태 | 연결 정상 / 실패 개수, 누적 수집 건수 |
| 처리 속도 (mps) | 초당 처리 건수 추이 그래프 |
게이지가 빨갛게 변한다면 자원이 부족하다는 의미입니다. 시스템 관리자에게 문의하세요.
모터센스 (Motor Sense) 의 경우
MOTOR_SENSE 타입 연결은 일반 태그 표 대신 에셋(자산) 별 카드 형식으로 표시됩니다.
- HEALTH INDEX 카드 — 자산 건강 지수 (불균형 / 정렬 / 베어링 등)
- SIGNAL 카드 — 진동 / 온도 / 전압 등 신호 값
1 초 주기로 자동 갱신되며 별도 새로고침 표시는 없습니다.
외부 시스템에서 값 가져가기
다른 시스템 (대시보드, 분석 도구 등) 이 게이트웨이에서 값을 받아가야 한다면 다음 방법 중 골라 쓸 수 있습니다.
| 방법 | 누가 쓰나요 |
|---|---|
| MQTT 구독 | 일반 IIoT 시스템 |
| Sparkplug B 구독 | Ignition / HiveMQ Edge / 표준 SCADA |
| REST API 조회 | 자체 개발한 대시보드 / 백엔드 |
| OPC-UA 서버로 노출 | 외부 SCADA 가 OPC-UA 클라이언트로 접속 |
자세한 설정 / 토픽 / 엔드포인트 스펙은 고급 — REST API / 고급 — Sparkplug B 에 있습니다.
자주 묻는 질문
Q. 값이 들어오긴 하는데 갱신이 너무 느려요
태그 등록 시 수집 주기 가 너무 길게 설정됐을 가능성이 큽니다. PLC 등록 [수정] 에서 수집 주기 (ms) 를 줄여보세요. 보통 1000ms (= 1초) 가 무난합니다.
Q. 화면 갱신이 5 초가 너무 길어요
/ui/connect/list 의 표 갱신은 5 초입니다. 한 태그를 더 빨리 보고 싶으면 그 태그를 클릭해 단일 태그 라이브 차트 (/ui/connect/tag-view) 로 이동 — 1 초 폴링 입니다. 여러 태그를 동시에 빠르게 보려면 별도 대시보드 도구 (Grafana 등) 를 함께 사용하세요. 애플리케이션 관리 참고.
Q. 같은 PLC 의 어떤 태그는 정상, 어떤 태그는 오류 인 경우
특정 태그만 오류라면 그 태그의 PLC 주소 표기 가 잘못됐거나 형식 보조 (format) 가 안 맞는 경우가 대부분입니다. 그 한 줄만 [수정] 으로 다시 점검해보세요.