연결 관리
목차
- 개요
- 화면 구성 — 3개 하위 메뉴
- 프로토콜 화면 (
/connect/index) - 상태 화면 (
/connect/status) - 데이터소스 상세 화면 (
/connect/view) - 엣지 화면 (
/edge/index) - 엣지 상세 화면 (
/edge/view) - 활용 시나리오
- 자주 묻는 질문
- 관련 화면
개요
Connectivity 그룹은 외부 시스템(현장 PLC·OPC 서버·파일·외부 DB·MQTT/Kafka 토픽 등)으로부터 데이터를 수집하기 위한 연결을 등록·점검합니다. 메뉴는 다음 3개 하위 화면으로 구성됩니다.
| 하위 메뉴 | 내부 URL | 용도 |
|---|---|---|
| 프로토콜 | /connect/index | 새 연결 등록 — 데이터소스 종류별 추가 진입점 |
| 연결 상태 | /connect/status | 운영 중 연결의 통신 상태·지연·검증 실패 모니터링 |
| 엣지 | /edge/index | 현장 엣지 디바이스의 시스템 상태와 PLC 수집 통계 |
화면 구성 — 3개 하위 메뉴
| 화면 | 주된 사용자 | 한줄 요약 |
|---|---|---|
| 프로토콜 | 시스템 관리자 | 새 데이터소스(엣지/OPC/PLC/Modbus/외부 DB/파일·API) 추가 |
| 연결 상태 | 운영자 | 연결 정상/지연/이상 트렌드와 24시간 단절·지연·검증 실패 이력 |
| 엣지 | 운영자 | 엣지의 OS 상태(CPU/메모리/디스크/네트워크) + PLC 수집 통계 |
이 문서와 화면에서 쓰는 연결 상태 이름은 연결됨 · 연결지연 · 연결이상 · 연결끊김 · 미관측
다섯 가지입니다. 코드값은 차례로 OK · WARN · ERROR · DISCONNECTED · UNKNOWN 이고,
정의는 상태 코드 정의 에 있습니다.
자산 트리 범례 등 일부 오래된 화면은 OK 를 "정상연결" 로 적기도 합니다 — 같은 상태입니다.
프로토콜 화면 (/connect/index)
상단에 안내 박스가 표시됩니다.
🌐 산업용 프로토콜 및 기타 데이터소스에 대한 연결 [추천] 플랜트펄스 엣지 게이트웨이와는 설정 없이 완벽하게 통합됩니다. 산업에서 많이 사용하는 OPC 와 PLC, Modbus 프로토콜 및 데이터베이스에 연결하여 데이터를 수집할 수 있습니다. 또한 추가적으로 제공되는 클라이언트 API 를 통해 MQTT, STOMP, KAFKA, HTTP 에서도 수집할 수 있습니다. (OPC는 자동으로 연결, 그 외는 프로토콜에 해당하는 엣지 게이트웨이 또는 콜렉터를 사용)
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 맨 위 | 안내 박스 — 아래 문구 그대로 |
| ② | 첫 섹션 | 엣지 게이트웨이 / 파일 / API [84] — 대괄호 숫자는 지금 등록된 연결 수 |
| ③ | 섹션 우측 | 목록보기 — 그 카테고리의 연결 목록 화면으로 |
| ④ | 카드 하단 | 연결하기 — 그 종류의 등록 폼 을 엽니다 |
| ⑤ | OPC [37] — 플랫폼이 직접 붙는 유일한 계열 | |
| ⑥ | PLC [135] — 제조사별 프로토콜 | |
| ⑦ | Modbus [6] | |
| ⑧ | 마지막 | 데이터베이스 [0] — 등록된 것이 없으면 [0] 입니다 |
데이터소스 카테고리
페이지는 카테고리별로 큰 섹션을 나누고, 각 섹션에 데이터소스 종류의 아이콘 카드(연결하기 링크 포함)가 격자로 표시됩니다.
| 섹션 | 표시 카드 | 추가 링크 |
|---|---|---|
엣지 게이트웨이 / 파일 / API [N] | 엣지 게이트웨이·MQTT·REST API·Excel·CSV (5종) | /connect/file/add |
OPC [N] | OPC 표준 데이터소스 (자동 연결) | /connect/opc/index 목록 |
PLC [N] | PLC 통신 (제조사별 프로토콜) | /connect/plc/index 목록 |
Modbus [N] | Modbus TCP/RTU | /connect/modbus/index 목록 |
데이터베이스 [N] | 외부 DB 폴링 | /connect/database/index 목록 |
각 섹션의 라벨 옆 [N] 는 현재 등록된 연결 수입니다. 우측 "목록보기" 링크로 카테고리별 목록 화면으로 이동합니다.
OPC 목록 화면 (/connect/opc/index)
데이터소스 카테고리의 OPC 행에서 "목록보기" 또는 사이드 메뉴를 통해 진입합니다. 등록된 모든 OPC 서버 연결의 운영 상태를 12 컬럼 표로 한눈에 봅니다.
| 컬럼 | 폭 | 표시 |
|---|---|---|
| No. | 60px | 행 번호 |
| 연결 ID | 100px | OPC 도메인 뱃지 |
| OPC 명 | 250px | 표시명 |
| 상태 | 70px | 풀컬러 그라디언트 상태 도트 (정상/지연/이상/끊김/미상) |
| 프로토콜 타입 | 60px | 다크 뱃지 — protocol-badge-opc-ua (네이비) / protocol-badge-opc-da (보라). 검은 배경 + 흰 글자로 다른 컬럼 뱃지와 즉시 구분 |
| 프로그램 ID | IP | 자동 | OPC 서버의 ProgID 또는 IP 주소 |
| 시작 | 60px | ▶ 수집 시작 / ◼ 중지 (현재 상태에 따라 표시) |
| 수집 시작시간 | 120px | 수집을 시작한 시각 (scan_start_time) |
| 연결된 태그수 | 70px | 그 OPC 에 매핑된 태그 수 |
| 전체 / 수신 포인트 | 80px | 누적 / 오늘 수신 포인트 건수 |
| 에러 | 60px | 누적 에러 건수 (빨강 강조) |
| 액션 | 80px | 🔧 편집 / 🗑 삭제 (변경 권한이 있는 역할만 동작) |
표 헤더 우측의 ↻ 아이콘 버튼으로 새로고침. 도움말 박스가 화면 하단에 표시되어 OPC 연결 권장 사항(연결당 1,000 태그 이하 등)을 안내합니다.
새 연결 추가 (/connect/{opc,plc,modbus,messaging,database,api}/add)
각 카드의 연결하기 링크를 누르면 등록 폼이 열립니다.
OPC · PLC · Modbus · 메시징 · 데이터베이스 · API 여섯 가지 등록 폼은 입력 항목이 완전히
같습니다(제품의 _connection-form-body.jsp 하나를 여섯 화면이 함께 씁니다).
제목·아이콘·저장 주소와, 고를 수 있는 프로토콜 목록(그 소스 유형의 것)만 다릅니다.
프로토콜별 세부 설정 — 폴링 주기, 인증, 토픽, 파일 경로, 레지스터 주소 —
은 이 폼에 없습니다. 여기서는 «어떤 장비가 어디에 있는가» 만 등록하고, 실제 수집
설정은 그 프로토콜을 담당하는 엣지 게이트웨이 또는 콜렉터 쪽에서 합니다
(플랫폼이 직접 수집하는 프로토콜은 API 와 POSTGRESQL 입니다).
입력 항목 (공통)
| 입력 | 필수 | 규칙 | 설명 |
|---|---|---|---|
| 사이트 명 | ✅ | 목록에서 선택 | 이 연결이 속할 사이트 |
| 연결 ID | ✅ | OPC_ 로 시작, 대문자·숫자·_ | 등록 후 수정 불가 (수정 모드에서는 읽기 전용) |
| 소스 유형 | — | 읽기 전용 | 고른 프로토콜에서 정해집니다 (OPC / PLC / MODBUS / DATABASE / MESSAGING / API / SYSTEM) |
| 연결 명 | ✅ | 사람이 읽는 이름 | |
| 프로토콜 | ✅ | 목록에서 선택 | 실제 프로토콜 — 아래 표 |
| 엣지 | — | 읽기 전용 | 이 연결을 수집하는 엣지. 플랫폼이 직접 수집하는 프로토콜이면 「플랫폼이 직접 수집합니다」 |
| 소스 IP | — | 최대 255자, IP 또는 호스트명 | 실제 소스(PLC·장치·OPC UA 서버·DB·브로커)의 주소 |
| 소스 포트 | — | 0 ~ 65535 | 실제 소스의 포트 |
| 설명 | ✅ | 메모 |
OPC_ 로만 시작한다검증식은 ^OPC_[A-Z0-9_]+$ 하나입니다. PLC_001 · EDGE_00303 · DB_ERP 는 저장되지 않습니다.
엣지의 자기감시 연결은 OPC_SYSTEM_<edge_id> 이고, 엣지가 동기화로 직접 선언합니다 — 화면에서 만들지 않습니다.
소문자로 쳐도 입력 즉시 대문자로 바뀌고, 허용되지 않는 문자는 지워집니다.
엣지가 수집하는 연결(엣지 칸이 채워진 연결)의 프로토콜 · 소스 IP · 소스 포트는 엣지의 동기화만 씁니다. 화면에서는 읽기 전용입니다. 엣지가 수집하는 프로토콜인데 엣지가 아직 기록되지 않았으면 「엣지 미확인」 뱃지가 뜹니다 — 엣지가 다음에 동기화하면 채워집니다.
프로토콜 — 붙일 수 있는 값 (47종)
목록은 화면에 하드코딩된 것이 아니라 mm_opc_protocol 표에서 읽어오고, 그 표의 정본은 plantpulse-event 의
프로토콜 카탈로그입니다(CI 가 둘을 대조합니다). 아래는 카탈로그 기준 목록입니다.
소스 유형과 수집 주체(엣지 / 플랫폼)는 프로토콜에서 정해집니다.
OPC (1)
| 값 | 설명 | 수집 |
|---|---|---|
OPCUA | OPC UA | 엣지 |
PLC (33)
| 값 | 설명 | 수집 |
|---|---|---|
AB-ETH | Allen-Bradley AB-Ethernet (CSP/PCCC, PLC-5/SLC-500) | 엣지 |
ADS | Beckhoff TwinCAT/ADS | 엣지 |
BACNET | BACnet/IP (HVAC/building automation) | 엣지 |
CANOPEN | CANopen (motion) | 엣지 |
CCLINK_IE | Mitsubishi CC-Link IE Field | 엣지 |
DALI | DALI (lighting) | 엣지 |
DELTAV | Emerson DeltaV (DCS) | 엣지 |
DNP3 | DNP3 (power/utility) | 엣지 |
EIP | Allen-Bradley EtherNet/IP | 엣지 |
FATEK | FATEK FBs | 엣지 |
FINS | OMRON FINS | 엣지 |
FOCAS | Fanuc FOCAS (CNC) | 엣지 |
GE | GE SRTP / PACSystems | 엣지 |
HART | HART-IP (4-20mA + digital) | 엣지 |
IEC104 | IEC 60870-5-104 telecontrol | 엣지 |
IEC61162_450 | IEC 61162-450 shipboard ethernet (NMEA over UDP) | 엣지 |
IEC61850 | IEC 61850 MMS (substation) | 엣지 |
IO_LINK | IO-Link (sensor master) | 엣지 |
KEYENCE_KV | Keyence KV series PLC | 엣지 |
KNXNET | KNXnet/IP (lighting/shading) | 엣지 |
LOGIX | Allen-Bradley ControlLogix/CompactLogix | 엣지 |
LS | LS ELECTRIC XGI/XBC/XBM | 엣지 |
MBUS | M-Bus (metering) | 엣지 |
MELSEC | Mitsubishi MELSEC | 엣지 |
MEWTOCOL | Panasonic MEWTOCOL | 엣지 |
MOTOR_SENSE | Motor Sense | 엣지 |
MTCONNECT | MTConnect machine tool data | 엣지 |
NMEA | NMEA 0183/2000 (marine) | 엣지 |
OP | Atlas Copco Open Protocol (tightening) | 엣지 |
PROFINET | Siemens PROFINET IO | 엣지 |
S7 | Siemens S7 | 엣지 |
SECSGEM | SECS/GEM (semiconductor fab) | 엣지 |
SNMP | SNMP network device polling | 엣지 |
Modbus (3)
| 값 | 설명 | 수집 |
|---|---|---|
MODBUS | Modbus TCP | 엣지 |
MODBUSUDP | Modbus UDP | 엣지 |
MODBUS_RTU | Modbus RTU (serial) | 엣지 |
데이터베이스 (1)
| 값 | 설명 | 수집 |
|---|---|---|
POSTGRESQL | PostgreSQL | 플랫폼 |
메시징 (7)
| 값 | 설명 | 수집 |
|---|---|---|
COAP | CoAP (RFC 7252) | 엣지 |
HTTP | HTTP push | 엣지 |
KAFKA | Apache Kafka | 엣지 |
MQTT_CLIENT | MQTT client | 엣지 |
ROS2 | ROS 2 (robot middleware) | 엣지 |
SPARKPLUG_B | Sparkplug B (MQTT) | 엣지 |
WEBSOCKET | WebSocket client | 엣지 |
API (1)
| 값 | 설명 | 수집 |
|---|---|---|
API | PlantPulse REST API | 플랫폼 |
시스템 (1)
| 값 | 설명 | 수집 |
|---|---|---|
EDGE | PlantPulse Edge Gateway (self-monitor) | 엣지 |
새 프로토콜은 plantpulse-event 의 프로토콜 카탈로그에 먼저 등록하고, 플랫폼 시드(mm_opc_protocol)에 같은 코드를
넣습니다 — CI 가 둘이 같은지 대조합니다. 다만 목록에 나타난다고 수집이 되는 것은
아닙니다 — 그 프로토콜을 실제로 말할 드라이버가 엣지 게이트웨이에 있어야 합니다.
엣지 프로토콜 가이드 에서 지원 여부를 먼저 확인하세요.
저장하면 — 연결된 태그 목록
폼 아래에는 항상 연결된 태그 목록 패널이 있습니다. 다만 목록이 채워지는 것은 수정 모드에서뿐입니다 — 신규 등록 화면에서는 비어 있는 것이 정상입니다.
| 컬럼 | 표시 |
|---|---|
| 선택 · 태그ID · 태그명 · 데이터 타입 · 단위 · 설명 · 액션 | 이 연결에 매핑된 태그 |
패널 헤더의 도구 — 전체선택 · 선택삭제 · 가상 태그 추가 · 새로고침. [가상 태그] 버튼은 이 연결에 가상 태그를 등록합니다 — 다른 태그 값으로 계산하는 태그입니다.
등록만으로는 메타만 잡힌 상태입니다. 상태 화면 에서 실제 데이터가 들어오는지 확인하세요 — 수집이 시작되면 카드에 "연결됨" 뱃지가 나타납니다.
상태 화면 (/connect/status)
운영 중 모든 데이터소스 연결의 상태를 한 화면에서 모니터링합니다.
상단 도구
📡 연결 상태 [총 N 개의 데이터소스 연결] [사이트 ▼] [검색] [↻]
| 컨트롤 | 폭 | 설명 |
|---|---|---|
사이트 셀렉터 (site_id) | 200px | 등록된 사이트 목록 (사이트명 [설명]). 늘 하나가 골라져 있습니다 |
| 검색 | 빨강 + 🔍 | 사이트 필터 적용 후 카드 갱신 |
| 새로고침 | 빨강 + ↻ | 화면 새로고침 |
좌측 — 통계 차트와 이력
좌측 col-lg-2 영역에 5개 차트와 3개 이력 패널이 세로로 배치됩니다.
1) 연결 상태 분포 (connection_stat_chart, 200px)
현재 등록된 모든 연결의 5단계 상태(연결됨·연결지연·연결이상·연결끊김·미관측) 분포를 도넛으로 표시.
2) 통신 연결 상태 트렌드 [오늘] (connection_trend_chart, 150px)
시간대별 상태별 연결 수의 추이 (최근 24시간).
| 색상 | 의미 | 임계값 |
|---|---|---|
| 🟢 녹색 | 연결됨 | 10분 이내 데이터 수신 |
| 🟠 주황 | 연결지연 | 10분 이상 미수신 |
| 🔴 빨강 | 연결이상 | 1시간 이상 미수신 |
| 🟥 진빨강 | 연결끊김 | 24시간 이상 미수신 |
| ⬜ 회색 | 미관측 | 데이터 수신 이력 없음 |
ℹ️ 헤더의 정보 아이콘에 마우스를 올리면 위 5단계 기준이 툴팁으로 표시됩니다.
3) 통신 지연 상태 트렌드 [오늘] (latency_trend_chart, 150px)
| 색상 | 의미 | 임계값 (구간 최대 지연) |
|---|---|---|
| 🟢 녹색 | 정상 | 10초 미만 |
| 🟠 주황 | 지연 | 10초 ~ 60초 |
| 🔴 빨강 | 심각 지연 | 60초 이상 |
툴팁에는 "평균 지연 1초 미만 / 1~10초 / 10초 이상" 이라고 나오지만, 막대를 만드는
계산은 그 시간 구간의 최대 지연(max_latency) 10초·60초 기준입니다. 막대를 읽을 때는
위 표를 쓰세요.
평균 지연 3초짜리 연결이 이 차트에서 녹색으로 보이는 것은 그래서입니다. 평균 기준 1초/10초는 자산 건강 상태 판정에 쓰이는 별개의 기준입니다 — 상태 코드 정의 에 두 기준을 나란히 정리해 두었습니다.
4) 포인트 검증 실패 트렌드 [오늘] (point_fail_trend_chart, 150px)
수신된 데이터 포인트의 타입·범위·유효성 검증에 실패한 건수를 시간 단위로 집계.
5) 최근 연결 끊김 [최근 24시간] (connection_status_history, 200px 스크롤)
24시간 동안 연결이 끊긴 데이터소스 이력. 시간 역순 목록 — 데이터소스 ID, 끊긴 시각, 마지막 정상 시각.
6) 최근 수신 지연 [최근 24시간] (connection_latency_history, 200px 스크롤)
24시간 동안 응답 지연이 발생한 데이터소스 이력.
7) 최근 포인트 검증 실패 [최근 24시간] (point_validation_status_history, 400px 스크롤)
24시간 동안 검증 실패가 발생한 포인트 이력.
우측 — 데이터소스 카드 그리드
우측 col-lg-10 영역에 카테고리별로 데이터소스 카드가 격자로 표시됩니다.
카드 카테고리 (위부터)
| 섹션 헤더 | 표시 |
|---|---|
엣지 게이트웨이 / 파일 / API [N] | FILE 타입 데이터소스 (엣지 GW·파일·API 등) |
PLC [N] | PLC 데이터소스 |
| (이하 OPC·Modbus·외부 DB 등) | 등록된 데이터소스 종류별 |
카드 구성 (opc_obj)
┌─────────────────────┐
│ [SUB_TYPE] │ ← 작은 글씨
│ OPC_ID │ ← ID
│ ──────────────── │
│ 현재 상태값(_mm) │ ← 매분 갱신 상태 표시
└─────────────────────┘
| 영역 | 표시 |
|---|---|
| 상단 | 데이터소스 서브타입 (예: FILE, MQTT, REST_API) |
| 중간 | 데이터소스 ID — 잘림 시 ellipsis(...) |
| 하단 | 매분 상태 표시 (${opc_id}_mm) — 색상이 5단계 상태에 매핑 |
카드 클릭 시 그 데이터소스의 상세 화면(
/connect/view?opc_id=...)으로 이동해 수집 이력·태그 목록·로그를 확인할 수 있습니다. hover 시 카드의 설명이 툴팁으로 표시됩니다.
빈 상태 안내
해당 카테고리에 데이터소스가 등록되지 않은 경우:
연결된 에이전트 없음
데이터소스 상세 화면 (/connect/view)
상태 화면 의 데이터소스 카드를 클릭하면 진입합니다. 한 OPC/PLC/DB 연결의 모든 운영 정보를 한 화면에 모은 뷰입니다.
페이지 헤더
📶 프로토콜 연결 보기 [📅 날짜 선택 ▼] [날짜 이동 →] [← 목록] [↻]
{site_name} / {opc_name}
| 컨트롤 | 동작 |
|---|---|
| 날짜 선택 | 캘린더 — 다른 날짜의 연결 상태 조회 |
| 날짜 이동 → | 선택한 날짜로 다시 로드 |
| ← 목록 | 상태 화면으로 복귀 |
| ↻ | 화면 새로고침 |
좌측 ① 연결 기본 정보 + 펼치기
패널 헤더 우측에 두 버튼:
| 버튼 | 동작 |
|---|---|
⌄ 펼치기 (viewOPCDetail()) | 사이트 정보 섹션 토글 표시 |
| ⚙ 연결 설정 | 그 데이터소스의 편집 양식으로 이동 (변경 권한 필요) |
기본 정보 (ds-dl)
| 항목 | 표시 |
|---|---|
| 연결 ID | OPC 도메인 뱃지 |
| 연결 명 | 데이터소스 표시명 |
| 설명 | 메모 |
| 등록일 | 등록 시각 (모노스페이스) |
프로토콜 연결 정보 (ds-dl)
| 항목 | 표시 |
|---|---|
| 연결 타입 | OPC_UA / OPC_DA / PLC / MODBUS / DB / FILE 등 |
| 하위 타입 | 제조사·세부 프로토콜 (예: SIEMENS_S7, MITSUBISHI_MC) |
| 에이전트 IP / 포트 | 에이전트(엣지)의 IP·포트 (모노스페이스) |
사이트 정보 (펼치기 시만)
| 항목 | 표시 |
|---|---|
| 사이트 ID | 사이트 도메인 뱃지 |
| 사이트 명 | 사이트 표시명 |
좌측 ② 연결 통계 (지연·상태 5종)
오늘 최고 지연 트렌드 (3 칸)
| 칸 | 표시 |
|---|---|
| 최저 | 가장 빠른 응답 지연 (ms, 콤마 구분) |
| 평균 | 평균 응답 지연 |
| 최고 | 가장 느린 응답 지연 |
아래에 24시간 지연 추이 라인 차트 (latency_24hh) — 평소와 다른 스파이크가 있으면 그 시각을 상태 화면에서 추가 확인.
연결이상 건수
읽기 전용 입력란에 오늘 누적 "연결이상" 카운트 표시.
상태 통계 5-셀 그리드
┌─🟢 연결─┐ ┌─🟠 지연─┐ ┌─🔴 이상─┐ ┌─⬛ 끊김─┐ ┌─⚪ 미관측┐
│ 12,453│ │ 23 │ │ 5 │ │ 1 │ │ 0 │
└────────┘ └────────┘ └────────┘ └────────┘ └────────┘
다섯 색상의 셀에 각각 누적 카운트가 큰 숫자로 표시되며, 아래에 작은 도넛 차트 (connection_priority_count_chart) 가 함께 표시됩니다.
우측 ① 연결 상태 타임라인 + LIVE 도트
패널 헤더 보조 텍스트: "오늘 연결/끊김 타임라인 [{status_txt}]". 헤더 우측에 ⓘ 정보 아이콘 — 호버 시 안내 툴팁.
좌측 — 현재 상태 카드 (live)
큰 아이콘 + 라벨 형태의 상태 카드 (last_connection_status).
| 아이콘 + 라벨 | 의미 | 도트 토글 |
|---|---|---|
❓ 미관측 (is-mute) | 데이터 수신 이력 없음 | ⚪ 회색 |
🟢 연결됨 (is-ok) | 10분 이내 데이터 수신 | 🟢 LIVE 도트 (펄스) |
🟠 연결지연 (is-warn) | 10분~1시간 미수신 | 🟠 |
🔴 연결이상 (is-err) | 1~24시간 미수신 | 🔴 |
⬛ 연결끊김 (is-disc) | 24시간 이상 미수신 | ⬛ |
🟢 LIVE 도트가 펄스로 깜빡이면 데이터가 실시간으로 들어오고 있는 상태입니다. 호버 시 마지막 수신 시각이 툴팁으로 표시됩니다.
우측 — 24시간 타임라인 막대 (opc_connection_timeline)
24시간을 가로 막대로 표시하며 각 시간대의 연결 상태가 5가지 색으로 칠해집니다. 막대에 마우스를 올리면 그 시각의 상태가 툴팁으로 표시됩니다.
우측 ② 포인트 수신 24시간 차트
패널 헤더 보조: "오늘 24시간 분당 수신 건수".
분당 포인트 수신 건수 라인 차트 (opc_point_trend_24h). 평소 영업시간대 대비 급락이 보이면 해당 시각의 데이터 인입이 끊긴 상태입니다. 로딩 중에는 "로딩중..." 안내가 중앙에 표시됩니다.
우측 ③ 연결된 태그 목록
이 데이터소스에 매핑된 태그들의 실시간 값 목록 (7 컬럼).
| 컬럼 | 폭 | 표시 |
|---|---|---|
| 태그 ID | 80px | 도메인 뱃지 |
| 태그 명 | 350px | 태그 표시명 |
| 데이터 타입 | 100px | INT/FLOAT/STRING/BOOL 등 |
| 현재 값 | 자동 | 마지막 수신 값 (품질 색상 뱃지) |
| 마지막 업데이트 시간 | 자동 | 수신 시각 |
| 지연 [MS] | 자동 | 평균 응답 지연 |
| 액션 | 50px | 🔍 → 그 태그 상세 로 이동 |
표는 WebSocket 으로 실시간 갱신됩니다. 값이 깜빡이지 않으면 그 태그의 수신이 끊긴 것입니다.
엣지 화면 (/edge/index)
현장에 설치된 엣지 디바이스의 시스템 상태와 PLC 수집 통계를 한 화면에서 모니터링합니다. 페이지 부제는 "엣지의 연결 상태와 PLC 데이터 수집 현황을 실시간 모니터링합니다." 입니다.
| 번호 | 자리 | 하는 일 |
|---|---|---|
| ① | 우측 상단 | 사이트 셀렉터와 검색 |
| ② | 상단 패널 | 엣지 신뢰도 요약 — 카드 6장 (아래) |
| ③ | 카드 하나 | 큰 숫자 + 라벨 + 한 줄 설명 |
| ④ | 목록 머리 | 건수와 마지막 조회 시각 |
| ⑤ | 표 머리 | 8개 열 |
| ⑥ | 첫 행 | 엣지 한 대 |
| ⑦ | 처리량 칸 | 현재 속도(mps) · 누적 포인트 · 24시간 스파크라인 |
| ⑧ | 액션 칸 | 상세 · 새로고침 · 전원 · 로그 · 설정 · 신뢰도 보기 |
엣지 신뢰도 요약 — 카드 6장
패널 부제 그대로 「연결, PLC, 지연, 자원 상태를 한눈에 확인합니다」 입니다. 앞 셋은 엣지 대수, 뒤 셋은 PLC 대수를 셉니다 — 단위가 다르니 합이 맞지 않는 것이 정상입니다.
| 카드 | 세는 것 | 설명 |
|---|---|---|
| 전체 | 엣지 | 모니터링 대상 엣지 |
| 연결됨 | 엣지 | 플랫폼이 도달 가능 |
| 연결끊김 | 엣지 | 플랫폼이 못 닿음 · 미관측 |
| PLC 정상 | PLC | 연결 + 수집 정상인 PLC 대수 |
| PLC 수집중단 | PLC | 연결됐으나 수집 안 되는 PLC 대수 |
| PLC 끊김 | PLC | 끊긴 PLC 대수 — 즉시 조치 |
신뢰도 보기 — 엣지 한 대의 진단
액션 칸(⑧)의 신뢰도 보기 를 누르면 우측에서 서랍이 열립니다. 신뢰도 등급 하나와 진단 항목 목록이 들어 있습니다.
| 진단 항목 | 언제 나오나 |
|---|---|
| 끊긴 PLC 연결 수 | 끊긴 PLC 가 하나라도 있을 때 — 🔴 |
| (수집 중단) | PLC 는 붙어 있는데 유입이 0일 때 — 🟡 |
| 도달 불가 엣지 수 | 연결이 끊겼거나(🔴) 아직 한 번도 관측되지 않았을 때(🟡) |
| 시스템 오류 | 로그의 오류 건수가 0보다 클 때 — 🟡 |
| 시스템 자원 | CPU · 메모리 · 디스크 중 하나라도 90% 이상일 때 — 🟡 |
| 이상 징후 없음 | 위 어느 것도 없을 때 — 🟢 |
등급(healthy / warning / critical)을 정하는 것은 PLC 연결과 수집 둘뿐입니다.
연결끊김 · 시스템 오류 · 자원 90% 초과는 진단 항목으로 «보이기만» 하고 등급을 바꾸지 않습니다. 그래서 「연결끊김인데 신뢰도가 critical 이 아닌」 조합이 나올 수 있습니다 — 고장이 아니라 축을 갈라 놓은 설계입니다. 등급만 보지 말고 진단 항목을 함께 읽으세요.
「미관측」은 장애가 아니라 아직 한 번도 올라온 적이 없는 상태입니다. 즉시 조치가 아니라 등록이 제대로 됐는지 확인할 대상입니다.
예전에는 지연 진단 항목이 있었지만 지금은 없습니다. 지연 이상은 데이터소스 상세 화면 의 오늘 최고 지연 트렌드 가 정본입니다.
상단 도구
📡 엣지 [사이트 ▼] [검색] [↻]
| 컨트롤 | 폭 | 설명 |
|---|---|---|
사이트 셀렉터 (site_id) | 200px | 등록된 사이트. 늘 하나가 골라져 있습니다 |
| 검색 | 🔍 | 사이트 필터 적용 |
| 새로고침 | ↻ | 목록 즉시 재조회 |
목록은 60초마다 자동으로 다시 조회됩니다. 도움말 박스의 "매 10초" 는 화면 갱신 주기가 아니라 엣지가 서버로 자기 상태를 올리는 주기입니다 — 둘을 헷갈리기 쉽습니다. 방금 바뀐 값을 바로 보려면 ↻ 를 누르세요.
목록 테이블 (8컬럼)
관련 지표들은 컬럼 하나에 묶여 있습니다. 예전처럼 CPU·메모리·디스크가 각각 한 컬럼씩 차지하지 않습니다.
┌────────────────────────── 목록 ──────────────────────────┐
│ 연결 │ EDGE_ID │ 엣지 │ 리소스 │ 네트워크 │ PLC │ 처리량 │ 액션 │
└──────────────────────────────────────────────────────────┘
| 컬럼 | 폭 | 표시 |
|---|---|---|
| 연결 | 60px | 연결 상태 아이콘 뱃지 (🔌 연결끊김 / ⚠ 경고) |
| EDGE_ID | 130px | 엣지 디바이스 식별자 |
| 엣지 | 260px | 엣지 이름 (+ O/S 호스트명·버전) |
| 리소스 | 150px | CPU · 메모리 · 디스크 사용률을 한 칸에 |
| 네트워크 | 110px | NET 1 / NET 2 / WiFi / VPN 상태를 한 칸에 |
| PLC | 80px | PLC 연결정상 / 연결끊김 수 |
| 처리량 | 110px | 현재 수집 속도(mps) · Σ 누적 수신 포인트 + 최근 24시간 시간당 수신량 스파크라인 |
| 액션 | 110px | 상세 보기 등 |
처리량 칸의 스파크라인에서 빈 구간은 "0건 수신" 이 아니라 "관측 없음" 입니다. 셀에 마우스를 올리면 같은 설명이 툴팁으로 나옵니다.
엣지 도움말 박스
페이지 하단에 다음 운영 가이드가 표시됩니다 (항목 4개).
❓ 엣지 도움말 엣지 메뉴에서는 엣지의 연결 및 PLC 데이터 수집 상태를 확인하실 수 있습니다.
- 상태가 연결끊김 [🔌] 으로 표시되는 엣지는 반드시 물리적 환경, 네트워크 및 엣지 O/S 를 체크하십시오.
- 상태가 경고 [⚠] 로 표시되는 엣지는 수집 시 S/W 오류 건수가 존재하는 상황으로, 엣지에 접속해서 문제를 해결하십시오.
- CPU/메모리/디스크가 80% 이상 사용될 때는 엣지를 확인 후 자원을 정리하십시오.
- 엣지의 상태는 매 10초마다 업데이트됩니다.
운영 절차 (이상 발견 시)
- 연결이 🔌(연결끊김) 인 엣지 → 현장 점검 (전원·네트워크·하드웨어)
- CPU/메모리/디스크 80% 이상 → 엣지에 접속해 불필요 프로세스/로그 정리
- PLC 연결끊김 수가 0이 아님 → 그 엣지의 PLC 케이블·설정 점검
엣지 상세 화면 (/edge/view)
엣지 목록의 EDGE_ID 또는 "액션" 컬럼을 클릭하면 진입하는 단일 엣지의 상세 화면입니다. 한 화면에서 다음을 처리할 수 있습니다.
- 등록 메타데이터 / 호스트 / 네트워크 / 보안 키 확인
- CPU·메모리·디스크 실시간 게이지
- PLC 수집 통계 8개 지표
- 엣지에 연결된 OPC 서버 목록과 수집 시작/중지
- 엣지 위에 떠있는 도커 컨테이너 목록과 시작·중지·재시작·로그·삭제
- 신규 컨테이너 원격 배포
- 엣지 애플리케이션 재시작 및 엣지 호스트 OS 리부트
⚠️ 이 화면의 모든 제어 명령은 현장 엣지 디바이스에 직접 실행됩니다. 실서비스 중인 엣지는 OPC 수집 중지·컨테이너 삭제·시스템 리부트 시 수집 데이터가 끊깁니다. 반드시 정비 시간대에 수행하세요.
상단 페이지 헤더와 새로고침
🛜 ${엣지명} [← 목록] [⚡ 실시간 새로고침] [↻ 새로고침]
사이트: ${site_id} · 엣지 ID: ${edge_id} · ${설명}
| 컨트롤 | 동작 |
|---|---|
| ← 목록 | /edge/index 로 복귀 |
| ⚡ 실시간 새로고침 | 엣지 장비를 직접 호출해 게이지·OPC 목록·도커 목록을 최신값으로 갱신 |
| ↻ 새로고침 | 페이지 전체 새로고침 |
이 화면에서 자동으로 도는 것은 두 가지뿐입니다.
| 대상 | 주기 | 출처 |
|---|---|---|
| 좌측 정보 패널·PLC 통계 등 저장된 값 | 30초 | 플랫폼에 저장된 read-model (/edge/{id}/model) — 엣지가 약 60초 하트비트로 올린 값 |
| 업그레이드 가능 여부 확인 | 5분 | — |
시스템 자원 게이지 · OPC 목록 · 도커 컨테이너 목록은 화면에 들어올 때 한 번만 엣지를 직접 호출합니다. 그 뒤로는 ⚡ 실시간 새로고침 을 누를 때만 다시 읽습니다. 장비를 매초 두드리지 않으려고 일부러 이렇게 되어 있습니다.
그래서 화면을 오래 열어두고 게이지를 보고 있으면 그 값은 들어온 시점의 값입니다. 현장에서 뭔가 조치한 뒤 결과를 확인하려면 반드시 ⚡ 를 누르세요.
연결 / 건강 타임라인 탭
통계 영역은 탭 2개로 나뉩니다.
| 탭 | 내용 |
|---|---|
| 연결 상태 타임라인 (기본 선택) | 지난 24시간 도달성 |
| 건강 상태 타임라인 | 지난 24시간 PLC 연결 & 수집 |
건강 타임라인은 탭을 눌러 화면에 보일 때 그려집니다. 탭을 열기 전에는 비어 있는 것이 정상입니다.
좌측 — 기본 정보·호스트·네트워크·보안 4 패널
좌측 col-lg-3 영역에 4개 패널이 세로로 쌓입니다. 모두 정의 리스트(label / value) 형식입니다.
① 기본 정보 — 시스템 리부트 버튼 포함
| 항목 | 의미 |
|---|---|
| 엣지 ID | 도메인 ID 뱃지 (EDGE 도메인 색상) |
| 이름 | edge_name |
| 사이트 | 사이트 ID (도메인 뱃지) |
| 역할 | role (없으면 -) |
| 상태 | 마스터 테이블의 status 값 |
| 설명 | 메모 |
| 등록일 | 엣지가 처음 등록된 일시 |
| 최근 상태 | 마지막으로 heartbeat 가 수신된 일시 |
패널 헤더 우측에 🔴 빨간색 ⏻ 전원 아이콘 버튼 — 클릭하면 엣지 호스트 OS 리부트 (아래 안전 절차 참고).
② 호스트
| 항목 | 의미 |
|---|---|
| 호스트명 | 운영체제의 hostname |
| 버전 | 엣지 소프트웨어 빌드 버전 |
| 빌드일 | 빌드된 날짜 |
| CPU 코어 | 코어 수 |
| 스레드 | 스레드 수 |
| 온도 | CPU 온도 (°C) — 보드에 온도 센서가 없으면 0 |
③ 네트워크
VPN / NET 1 / NET 2 / WiFi / 관리망 / GSM 6개 인터페이스의 IP. 미설정 시 -.
| 항목 | 용도 |
|---|---|
| VPN IP | 본사 ↔ 현장 VPN 터널의 엣지측 주소 |
| NET 1 | 1차 LAN |
| NET 2 | 2차 LAN |
| WiFi | 무선 |
| 관리망 | OOB 관리망 |
| GSM | LTE/3G 백업 회선 |
④ 보안
| 항목 | 표시 |
|---|---|
| API Key | 엣지가 서버에 인증할 때 사용하는 키 — 앞 4자 + **** + 뒷 4자 마스킹 |
Flow REST 노드의 X-API-Key 와 동일한 키 — 이 화면에서 마스킹 형태만 확인할 수 있고, 실제 키 값은 표시되지 않습니다.
우측 ① 시스템 자원 게이지 + 앱 재시작
패널 헤더에 ⓘ "CPU · 메모리 · 디스크 사용률 (실시간)" 라벨, 우측에 앱 재시작 버튼.
상태 라인 (state-row)
게이지 위에 한줄 상태 메시지가 표시됩니다.
| 표시 | 의미 |
|---|---|
🟢 엣지 LIVE — 정상 응답 중 | 엣지가 ping 에 응답 |
🔴 엣지 OFFLINE | edge 의 /api/v1/monitoring 이 ping=false |
🔴 엣지 UNREACHABLE | HTTP 요청 자체가 실패 (네트워크 단절) |
게이지 3개 (각 140px 도넛)
| 게이지 | 단위 | 색상 임계 |
|---|---|---|
| CPU 사용률 | % | < 80 녹색 · 80~89 주황 · ≥ 90 빨강 |
| 메모리 사용률 | % | 동일 |
| 디스크 사용률 | % | 동일 |
값은 소수 1자리까지 표시됩니다 (예: 73.4%).
앱 재시작 버튼
엣지 애플리케이션(데몬)만 재시작합니다. 호스트 OS 는 영향 없음.
🔄 누르면 확인 다이얼로그 → "재시작" → 약 3초 뒤 엣지 프로세스가 자체 재시작되며 약 10초 후 복귀합니다. 그 동안 게이지·통계는 임시로
-표시.
우측 ② PLC / 수집 통계 (8칸 stat-box)
8개 통계 박스가 격자로 배치됩니다.
| 박스 | 단위 | 의미 | 강조 |
|---|---|---|---|
| 연결 정상 | 건 | PLC 연결이 살아있는 수 | 🟢 ok |
| 연결 끊김 | 건 | PLC 연결이 끊긴 수 | 🔴 err |
| 읽기 성공 | 건 | PLC 폴링 성공 누적 카운터 | - |
| 읽기 실패 | 건 | PLC 폴링 실패 누적 카운터 | 🔴 err |
| 전송 포인트 | 건 | 서버로 전송된 누적 포인트 수 | - |
| MPS | 건/초 | 메시지 처리 속도 (초당 포인트) | - |
| 평균 지연 | MS | 최근 윈도우의 평균 응답 지연 | - |
| 최고 지연 | MS | 최근 윈도우의 최대 응답 지연 | - |
카운터(읽기 성공·실패·전송 포인트)는 엣지 프로세스가 재시작되면 0부터 다시 시작됩니다. 절대값이 아닌 추세로 해석하세요.
우측 ③ OPC 상태 + 5종 요약 칩 + 수집 시작/중지
패널 헤더에 "엣지에 연결된 OPC 서버 목록과 수집 상태".
5종 요약 칩 (opc-chip-v2)
칩 한 개는 아이콘 + 큰 숫자 + 라벨로 구성됩니다.
| 칩 | 아이콘 | 의미 | 색상 |
|---|---|---|---|
| 등록 | ☰ | 이 엣지에 매핑된 OPC 서버 총 개수 | 회색 |
| 연결 | ✓ | connection_status = CONNECTED 개수 | 🟢 녹색 |
| 수집중 | ≋ | 연결 정상 + scan_status = START | 🟢 녹색 |
| 중지 | ⏸ | scan_status = STOP 개수 | 회색 |
| 끊김 | 🔗∕ | connection_status ≠ CONNECTED 개수 | 🔴 빨강 |
목록 테이블 (7컬럼)
| 컬럼 | 폭 | 표시 |
|---|---|---|
| OPC ID | 160px | 🔌 + ID (클릭 시 /connect/opc/edit/{id} 편집 화면) |
| 이름 | 자동 | opc_name |
| 타입 | 80px | OPC UA / OPC DA 뱃지 |
| 에이전트 IP | 140px | OPC 에이전트 IP (모노스페이스) |
| 연결 | 90px | 🟢 CONNECTED / 🔴 그 외 — 도트로 표시 |
| 수집 | 90px | 🟢 START / 🟡 그 외 / ⚫ STOP — 도트 |
| 제어 | 160px | 액션 버튼들 (아래) |
제어 버튼
| 상태 조건 | 표시 버튼 | 동작 |
|---|---|---|
scan_status ≠ START | 🟢 ▶ 수집 시작 | 확인 → POST /edge/{edge_id}/opc/{opc_id}/start → 2초 뒤 화면 재로드 |
scan_status = START | 🔴 ◼ 수집 중지 | 확인 → POST /edge/{edge_id}/opc/{opc_id}/stop → 2초 뒤 화면 재로드 |
| 항상 표시 | ⚙ OPC 편집 | /connect/opc/edit/{opc_id} 편집 화면 이동 |
수집 중지 다이얼로그는 ⚠️ 경고색 (주황) 으로 표시됩니다 — 실제로 데이터가 끊깁니다.
우측 ④ 도커 컨테이너 (원격 배포·시작·중지·로그·삭제)
엣지 호스트의 도커에 떠있는 컨테이너 목록을 5초마다 갱신.
패널 헤더
| 버튼 | 동작 |
|---|---|
| ↻ | 즉시 새로고침 |
| ➕ 신규 배포 | 컨테이너 배포 다이얼로그 (이름·이미지·포트·환경변수 입력) |
목록 테이블 (6컬럼)
| 컬럼 | 폭 | 표시 |
|---|---|---|
| 이름 | 160px | ▢ 큐브 아이콘 + 컨테이너명 (굵게) |
| 이미지 | 자동 | 이미지 태그 (모노스페이스, 예: grafana/grafana:latest) |
| 상태 | 80px | 🟢 UP / 🔴 DOWN 칩 |
| 최근 상태 | 200px | docker status 텍스트 (예: Up 3 hours) |
| 포트 | 200px | 호스트:컨테이너/프로토콜 콤마 구분 |
| 제어 | 240px | 액션 버튼 5종 (아래) |
제어 버튼 (모든 행 공통)
| 버튼 | 색상 | 동작 |
|---|---|---|
| ▶ 시작 | 🟢 녹색 | POST /app/{name}/start |
| 🔄 재시작 | 🟡 주황 | POST /app/{name}/restart |
| ◼ 중지 | 🔴 빨강 | POST /app/{name}/stop (경고 다이얼로그) |
| 📄 로그 | 회색 | GET /app/{name}/logs → 와이드 다이얼로그에 컨테이너 표준 출력 표시 |
| 🗑 삭제 | 빨강 텍스트 | DELETE /app/{name} (위험 다이얼로그) — 실행 중이어도 강제 종료됩니다 |
신규 배포 다이얼로그
| 입력 | 예시 |
|---|---|
| 컨테이너 이름 | grafana |
| 이미지 | grafana/grafana:latest |
| 포트 (host:container, 콤마 구분) | 3000:3000 |
| 환경변수 (KEY=VAL, 콤마 구분) | GF_SECURITY_ADMIN_PASSWORD=admin |
배포는 엣지 호스트의 도커 데몬이 받아 이미지 pull + run 을 수행합니다. 이미지가 크면 시간이 걸리므로 목록 새로고침으로 진행 상황을 확인하세요.
시스템 리부트·앱 재시작 안전 절차
🔄 앱 재시작 (Edge 애플리케이션만)
- 시스템 자원 패널 우상단 앱 재시작 클릭
- 확인 다이얼로그 → "재시작"
- 약 3초 뒤 프로세스 자체 재시작
- 약 10초 후 복귀 — 게이지·통계 자동 채워짐
영향: PLC/OPC 수집이 약 10~15초 끊깁니다. CEP 알람 평가는 서버측에서 계속됩니다. 누적 카운터는 0부터 다시 시작.
⏻ 시스템 리부트 (Edge 호스트 OS)
좌측 ① 기본 정보 패널 헤더의 🔴 ⏻ 버튼.
- 확인 다이얼로그가 위험 (빨강) 으로 표시됨
- 약 1분 동안 응답이 없으며 OS 가 완전히 부팅된 후에야 복귀
- 부팅 중 PLC/OPC 모두 끊김 — 컨테이너도 함께 정지/재시작
다음 경우에만 사용하세요. ① 메모리/디스크가 100% 까지 차서 앱 재시작으로 회복이 안 되는 경우. ② 보드 자체가 응답이 느려진 경우. 일반적으로는 앱 재시작 으로 먼저 시도하세요.
활용 시나리오
| 시나리오 | 화면 | 절차 |
|---|---|---|
| 신규 라인 OPC 등록 | 프로토콜 → OPC 카드 → 연결하기 | 사이트·OPC ID·서버 주소 입력 → 저장 |
| 운영 중 연결 끊김 일괄 점검 | 상태 | 좌측 "최근 연결 끊김" 24시간 이력 → 우측 카드의 빨강·진빨강 카드 식별 |
| 포인트 검증 실패 원인 분석 | 상태 | 좌측 "포인트 검증 실패 트렌드" + "최근 검증 실패" → 자산 ID + 시각 → 트렌드 화면 비교 |
| 엣지 디바이스 자원 점검 | 엣지 | CPU/메모리/디스크 80% 이상 디바이스 식별 → 현장 정리 |
| PLC 단절 사이트 식별 | 엣지 | "PLC 연결끊김" 컬럼 정렬 → 0 아닌 사이트의 엣지 점검 |
| 네트워크 지연 분석 | 엣지 | "최고 지연 [MS]" 정렬 → 10초 이상 디바이스의 네트워크 점검 |
| 엣지 위 그라파나·통합 컨테이너 재시작 | 엣지 상세 → 도커 | 컨테이너 행의 🔄 재시작 (전체 화면 새로고침 불필요) |
| 현장 OPC 일시 정지 후 점검 | 엣지 상세 → OPC | 해당 OPC 행의 ◼ 수집 중지 → 점검 후 ▶ 수집 시작 |
| 엣지 응답 느려짐 회복 | 엣지 상세 → 시스템 자원 | 앱 재시작 (영향 10초). 회복 안 되면 ⏻ 시스템 리부트 (영향 1분) |
| 신규 모니터링 도구 원격 배포 | 엣지 상세 → 도커 → ➕ 신규 배포 | 이미지·포트·환경변수 입력 후 배포 — 이미지 pull 자동 |
자주 묻는 질문
Q. OPC 데이터소스를 등록했는데 [상태] 화면에 카드가 안 보입니다. A. 등록 직후에는 "미관측"(회색) 상태로 카드가 표시되어야 합니다. 보이지 않으면 사이트 셀렉터에서 그 OPC가 등록된 사이트를 선택했는지 확인하세요.
Q. [상태] 의 트렌드 차트가 비어 있습니다. A. 그 사이트에 데이터소스 자체가 없거나 오늘 인입 이력이 전혀 없는 경우입니다. 데이터소스를 등록한 직후라면 첫 인입까지 잠시 기다리세요.
Q. 차트 위 정보 아이콘 ℹ 의 툴팁이 잘려 보입니다. A. 정보 아이콘에 마우스를 올리면 5단계 상태 기준 표가 툴팁으로 표시됩니다. 화면 폭이 좁으면 잘릴 수 있으므로 화면을 더 넓게 하시거나 상태 코드 정의 화면을 참고하세요.
Q. 엣지 상태가 갱신되지 않습니다. A. 주기가 세 겹이라 헷갈리기 쉽습니다. ① 엣지가 서버로 상태를 올리는 주기 10초, ② 목록 화면이 서버에서 다시 조회하는 주기 60초, ③ 상세 화면의 저장 값 갱신 주기 30초. 그러니 목록에서 값이 최대 1분쯤 늦게 보이는 것은 정상입니다. 그보다 오래 멈춰 있다면 엣지가 응답을 보내지 못하는 상태입니다(연결끊김). 현장 점검 또는 진단 의 EDGE 애플리케이션 로그를 확인하세요.
Q. 상세 화면의 CPU 게이지가 계속 같은 값입니다. A. 게이지·OPC 목록·도커 목록은 자동으로 갱신되지 않습니다 — 화면 진입 시 1회만 엣지를 직접 호출합니다. ⚡ 실시간 새로고침 을 누르세요.
Q. PLC 연결끊김 컬럼이 1로 늘었는데 어떻게 확인하나요? A. 그 엣지의 액션 버튼으로 상세 화면에 가시면 PLC 단위 상태를 보실 수 있습니다. 또는 상태 화면의 PLC 카드 그리드에서 빨강 카드를 식별합니다.
Q. CPU/메모리 100% 인 엣지가 있어요. A. 즉시 현장에 접속해 불필요한 프로세스를 정리하시고, 반복된다면 디바이스 사양 업그레이드 또는 수집 주기 조정을 검토하세요.
Q. 카드를 클릭했더니 빈 화면이 나옵니다.
A. 데이터소스 상세 화면(/connect/view) 으로 이동하지만 인입 데이터가 없으면 빈 화면처럼 보일 수 있습니다. 데이터 인입 이력이 있는 데이터소스만 풍부한 정보가 표시됩니다.
Q. 실시간으로 자동 갱신되나요?
A. [상태] 화면의 카드 매분 표시(_mm)는 자동 갱신됩니다. 좌측 통계 차트는 일정 주기로 갱신되며, 즉시 반영하려면 우상단 ↻ 새로고침 버튼을 누르세요.
Q. "수신된 포인트 건수" 가 갑자기 0이 됩니다. A. 엣지의 카운터가 재시작되면 0부터 다시 시작됩니다. 진짜 0인지 카운터 리셋인지 일일 통계 화면의 사이트별 데이터 건수를 같이 확인하세요.
Q. 엣지 상세 화면(/edge/view)에서 OPC 수집을 중지했는데 시간이 지나면 다시 START 로 돌아옵니다.
A. 「자동 재시작」이라는 옵션은 없습니다. 원인은 둘 중 하나입니다.
- 엣지 수집기가 재기동됐다 — 연결에 「수집을 자동으로 시작」(
auto_collect) 이 켜져 있으면, 수집기가 기동할 때 그 OPC 를 START 로 올립니다. 켜 두고 화면에서 중지해도 다음 기동에서 다시 START 가 됩니다. 이 항목은 기동 시점에만 작동하므로, 돌고 있던 OPC 를 타이머로 되살리지는 않습니다 — 「시간이 지나면」의 정체는 재기동입니다. 끄는 자리는 엣지의 연결 추가·편집 화면의 체크박스입니다. - 밖에서 시작 명령이 들어왔다 —
POST /api/v1/opc/{opcId}/start로 누구든 수집을 켤 수 있습니다(이미 START 면 아무 일도 하지 않습니다). 연동 스크립트·상위 시스템을 의심하세요.
영구 중지가 필요하면 「수집을 자동으로 시작」을 끄거나 OPC 자체를 비활성화하십시오 — 화면에서 한 번 중지하는 것만으로는 부족합니다.
Q. 도커 컨테이너 패널이 비어 있습니다. A. ① 엣지가 도커 사용 모드가 아닐 수 있습니다 — 일부 엣지는 systemd 직접 기동 방식입니다. ② 엣지 OS 의 도커 데몬이 응답하지 않을 수 있습니다 (이 경우 ↻ 새로고침해도 비어 있음). 현장 점검 또는 ⏻ 시스템 리부트 검토.
Q. 컨테이너 ▶ 시작·🔄 재시작·◼ 중지 버튼이 모두 보입니다. 어떤 게 활성인가요? A. 모든 버튼은 항상 클릭 가능합니다 — 도커 상태와 무관하게 명령이 전송됩니다. 이미 실행 중인데 ▶ 시작을 누르면 오류 없이 무시되거나 재시작될 수 있으니, 상태 칩(🟢 UP / 🔴 DOWN) 을 보고 의도한 명령을 선택하세요.
Q. ⏻ 시스템 리부트와 🔄 앱 재시작의 차이는? A. ① 앱 재시작 (영향 10초) — 엣지 데몬 프로세스만 재기동, OPC/PLC 수집은 10초 끊김. ② 시스템 리부트 (영향 1분) — 엣지 호스트 OS 전체를 부팅, 도커 컨테이너까지 재시작. 일반적으로는 항상 앱 재시작을 먼저 시도하세요.
Q. API Key 가 마스킹되어 보이는데 실제 값을 확인하려면? A. 마스킹은 일부러 적용된 것입니다 — 화면 어느 곳에서도 평문 키는 보이지 않습니다. Flow REST 노드 의 X-API-Key 와 동일한 키이므로 처음 발급받았을 때 안전한 곳에 보관하세요. 분실 시에는 운영자에게 재발급을 요청하세요.