본문으로 건너뛰기

연결 관리

목차​

개요​

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 [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행 번호
연결 ID100pxOPC 도메인 뱃지
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 태그 이하 등)을 안내합니다.

새 연결 추가​

각 카드의 연결하기 링크를 클릭하면 해당 데이터소스 종류의 등록 폼이 열립니다. 폼은 데이터소스에 따라 입력 항목이 다르며 공통적으로 다음을 입력합니다.

공통 입력설명
사이트연결을 등록할 사이트 선택
OPC 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)​

항목표시
연결 IDOPC 도메인 뱃지
연결 명데이터소스 표시명
설명메모
등록일등록 시각 (모노스페이스)

프로토콜 연결 정보 (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 컬럼).

컬럼폭표시
태그 ID80px도메인 뱃지
태그 명350px태그 표시명
데이터 타입100pxINT/FLOAT/STRING/BOOL 등
현재 값자동마지막 수신 값 (품질 색상 뱃지)
마지막 업데이트 시간자동수신 시각
지연 [MS]자동평균 응답 지연
액션50px🔍 → 그 태그 상세 로 이동

표는 WebSocket 으로 실시간 갱신됩니다. 값이 깜빡이지 않으면 그 태그의 수신이 끊긴 것입니다.

엣지 화면 (/edge/index)​

현장에 설치된 엣지 디바이스의 시스템 상태와 PLC 수집 통계를 한 화면에서 모니터링합니다. 페이지 부제는 "엣지의 연결 상태와 PLC 데이터 수집 현황을 실시간 모니터링합니다." 입니다.

상단 도구​

📡 엣지                                        [사이트 ▼] [검색] [↻]
컨트롤폭설명
사이트 셀렉터 (site_id)200px전체 사이트 + 등록된 사이트
검색🔍사이트 필터 적용
새로고침↻목록 즉시 재조회

목록은 60초마다 자동으로 다시 조회됩니다. 도움말 박스의 "매 10초" 는 화면 갱신 주기가 아니라 엣지가 서버로 자기 상태를 올리는 주기입니다 — 둘을 헷갈리기 쉽습니다. 방금 바뀐 값을 바로 보려면 ↻ 를 누르세요.

목록 테이블 (8컬럼)​

관련 지표들은 컬럼 하나에 묶여 있습니다. 예전처럼 CPU·메모리·디스크가 각각 한 컬럼씩 차지하지 않습니다.

┌────────────────────────── 목록 ──────────────────────────┐
│ 연결 │ EDGE_ID │ 엣지 │ 리소스 │ 네트워크 │ PLC │ 처리량 │ 액션 │
└──────────────────────────────────────────────────────────┘
컬럼폭표시
연결60px연결 상태 아이콘 뱃지 (🔌 연결끊김 / ⚠ 경고)
EDGE_ID130px엣지 디바이스 식별자
엣지260px엣지 이름 (+ O/S 호스트명·버전)
리소스150pxCPU · 메모리 · 디스크 사용률을 한 칸에
네트워크110pxNET 1 / NET 2 / WiFi / VPN 상태를 한 칸에
PLC80pxPLC 연결정상 / 연결끊김 수
처리량110px현재 수집 속도(mps) · Σ 누적 수신 포인트 + 최근 24시간 시간당 수신량 스파크라인
액션110px상세 보기 등

처리량 칸의 스파크라인에서 빈 구간은 "0건 수신" 이 아니라 "관측 없음" 입니다. 셀에 마우스를 올리면 같은 설명이 툴팁으로 나옵니다.

엣지 도움말 박스​

페이지 하단에 다음 운영 가이드가 표시됩니다 (항목 4개).

❓ 엣지 도움말 엣지 메뉴에서는 엣지의 연결 및 PLC 데이터 수집 상태를 확인하실 수 있습니다.

  • 상태가 연결끊김 [🔌] 으로 표시되는 엣지는 반드시 물리적 환경, 네트워크 및 엣지 O/S 를 체크하십시오.
  • 상태가 경고 [⚠] 로 표시되는 엣지는 수집 시 S/W 오류 건수가 존재하는 상황으로, 엣지에 접속해서 문제를 해결하십시오.
  • CPU/메모리/디스크가 80% 이상 사용될 때는 엣지를 확인 후 자원을 정리하십시오.
  • 엣지의 상태는 매 10초마다 업데이트됩니다.

운영 절차 (이상 발견 시)​

  1. 연결이 🔌(연결끊김) 인 엣지 → 현장 점검 (전원·네트워크·하드웨어)
  2. CPU/메모리/디스크 80% 이상 → 엣지에 접속해 불필요 프로세스/로그 정리
  3. PLC 연결끊김 수가 0이 아님 → 그 엣지의 PLC 케이블·설정 점검

엣지 상세 화면 (/edge/view)​

엣지 목록의 EDGE_ID 또는 "액션" 컬럼을 클릭하면 진입하는 단일 엣지의 상세 화면입니다. 한 화면에서 다음을 처리할 수 있습니다.

  • 등록 메타데이터 / 호스트 / 네트워크 / 보안 키 확인
  • CPU·메모리·디스크 실시간 게이지
  • PLC 수집 통계 8개 지표
  • 엣지에 연결된 OPC 서버 목록과 수집 시작/중지
  • 엣지 위에 떠있는 도커 컨테이너 목록과 시작·중지·재시작·로그·삭제
  • 신규 컨테이너 원격 배포
  • 엣지 애플리케이션 재시작 및 엣지 호스트 OS 리부트

⚠️ 이 화면의 모든 제어 명령은 현장 엣지 디바이스에 직접 실행됩니다. 실서비스 중인 엣지는 OPC 수집 중지·컨테이너 삭제·시스템 리부트 시 수집 데이터가 끊깁니다. 반드시 정비 시간대에 수행하세요.

상단 페이지 헤더와 새로고침​

🛜 ${엣지명}                    [← 목록] [⚡ 실시간 새로고침] [↻ 새로고침]
   사이트: ${site_id} · 엣지 ID: ${edge_id} · ${설명}
컨트롤동작
← 목록/edge/index 로 복귀
⚡ 실시간 새로고침엣지 장비를 직접 호출해 게이지·OPC 목록·도커 목록을 최신값으로 갱신
↻ 새로고침페이지 전체 새로고침
게이지·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 11차 LAN
NET 22차 LAN
WiFi무선
관리망OOB 관리망
GSMLTE/3G 백업 회선

④ 보안​

항목표시
API Key엣지가 서버에 인증할 때 사용하는 키 — 앞 4자 + **** + 뒷 4자 마스킹

Flow REST 노드의 X-API-Key 와 동일한 키 — 이 화면에서 마스킹 형태만 확인할 수 있고, 실제 키 값은 표시되지 않습니다.

우측 ① 시스템 자원 게이지 + 앱 재시작​

패널 헤더에 ⓘ "CPU · 메모리 · 디스크 사용률 (실시간)" 라벨, 우측에 앱 재시작 버튼.

상태 라인 (state-row)​

게이지 위에 한줄 상태 메시지가 표시됩니다.

표시의미
🟢 엣지 LIVE — 정상 응답 중엣지가 ping 에 응답
🔴 엣지 OFFLINEedge 의 /api/v1/monitoring 이 ping=false
🔴 엣지 UNREACHABLEHTTP 요청 자체가 실패 (네트워크 단절)

게이지 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 ID160px🔌 + ID (클릭 시 /connect/opc/edit/{id} 편집 화면)
이름자동opc_name
타입80pxOPC UA / OPC DA 뱃지
에이전트 IP140pxOPC 에이전트 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 칩
최근 상태200pxdocker 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 애플리케이션만)​

  1. 시스템 자원 패널 우상단 앱 재시작 클릭
  2. 확인 다이얼로그 → "재시작"
  3. 약 3초 뒤 프로세스 자체 재시작
  4. 약 10초 후 복귀 — 게이지·통계 자동 채워짐

영향: PLC/OPC 수집이 약 10~15초 끊깁니다. CEP 알람 평가는 서버측에서 계속됩니다. 누적 카운터는 0부터 다시 시작.

⏻ 시스템 리부트 (Edge 호스트 OS)​

좌측 ① 기본 정보 패널 헤더의 🔴 ⏻ 버튼.

  1. 확인 다이얼로그가 위험 (빨강) 으로 표시됨
  2. 약 1분 동안 응답이 없으며 OS 가 완전히 부팅된 후에야 복귀
  3. 부팅 중 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. OPC 자체에 자동 재시작 옵션이 켜져 있거나, 워크플로로부터 자동 시작 명령이 들어왔을 가능성이 있습니다. OPC 편집 화면에서 자동 재시작 설정을 확인하세요. 영구 중지가 필요한 경우 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 와 동일한 키이므로 처음 발급받았을 때 안전한 곳에 보관하세요. 분실 시에는 운영자에게 재발급을 요청하세요.

관련 화면​