본문으로 건너뛰기

콘솔 탐색과 공통 화면

목차​

개요​

이 문서는 로그인 이후 모든 화면에서 공통으로 사용하는 콘솔 프레임을 설명합니다. 현재 콘솔은 상단 도메인 검색, 우측 실시간 툴바, 좌측 업무 그룹 메뉴, 카드·차트·테이블 기반 본문으로 구성됩니다.

전체 메뉴 맵과 업무 흐름도는 전체 메뉴 구조와 운영 흐름도 에서 한눈에 볼 수 있습니다.

운영자는 보통 다음 흐름으로 사용합니다.

  1. 대시보드 에서 사이트 지도, 파이프라인, KPI, 인프라 헬스를 확인합니다.
  2. 이상 KPI 를 클릭해 연결 상태, 알람, 설비, 일일 통계 로 내려갑니다.
  3. 상단 도메인 검색으로 사이트·에셋·태그·OPC·엣지·플로우·알람 설정 ID 를 바로 찾아 상세 화면으로 이동합니다.
  4. 우측 상단 LIVE·알람·토스트에서 새 이상 신호를 확인합니다.

예전 문서의 "요약" 첫 화면은 현재 UI 에서 대시보드로 정리되었습니다. 내부 URL 은 계속 /map/index 입니다.

전체 화면 프레임​

┌──────────────┬────────────────────────────────────────────────────────────┐
│ PlantPulse   │ ☰  [도메인 검색  사이트 / 에셋 / 태그 / OPC / ... CTRL+K] │
│ 좌측 메뉴     │                         [LIVE] [알람] [전체] [설정] [매뉴얼] [사용자] │
├──────────────┼────────────────────────────────────────────────────────────┤
│ Overview     │ 페이지 제목 / 현재 업무 설명                                │
│ Connectivity │ ┌────────────────────────────────────────────────────────┐ │
│ Factory      │ │ 지도·카드·차트·테이블·트리·드로어 등 선택 화면 본문        │ │
│ ...          │ └────────────────────────────────────────────────────────┘ │
└──────────────┴────────────────────────────────────────────────────────────┘
영역역할
상단 바메뉴 접기, 전역 도메인 검색, LIVE 상태, 알람, 전체화면, 환경설정, 매뉴얼, 사용자 메뉴
좌측 메뉴실제 서버웹 nav-role/admin.jsp 기준의 업무 그룹 메뉴
본문 상단페이지 제목, 현재 사이트/업무 컨텍스트, 조회·새로고침·이동 버튼
본문 영역지도, 카드, 차트, 테이블, 트리, 상세 패널
토스트 영역우측 상단에 실시간 진단·알람 이벤트를 짧게 표시

상단 바​

상단 바는 모든 화면에서 동일하게 동작합니다.

순서요소사용법
1메뉴 토글좌측 메뉴를 접거나 펼칩니다. 좁은 화면에서 본문 공간을 확보할 때 사용합니다.
2도메인 검색클릭 또는 Ctrl+K / Mac Cmd+K 로 엽니다. 콘솔 전체 도메인 ID 를 검색합니다.
3LIVE 상태웹소켓 연결 상태입니다. 정상일 때 LIVE 도트가 펄스 형태로 표시됩니다.
4알람최근 알람 수와 미리보기를 표시합니다. 메뉴 푸터에서 알람 으로 이동합니다.
5전체화면브라우저 전체화면을 토글합니다.
6환경설정화면 배율, 알람 팝업, 진단 로그 표시 같은 사용자 화면 설정을 엽니다.
7매뉴얼GitBook 매뉴얼을 새 탭으로 엽니다.
8사용자 메뉴프로필, 비밀번호 변경, 로그아웃을 제공합니다.

상단 검색은 화면별 검색 폼과 다릅니다. 화면별 검색은 현재 목록을 필터링하고, 도메인 검색은 콘솔 전체의 주요 ID 를 찾아 상세 화면으로 이동합니다.

도메인 통합 검색​

도메인 검색은 /api/v4/domain/search 를 호출해 결과를 DataTable 로 표시합니다. ID 셀은 클릭하면 클립보드에 복사되고, 액션 버튼은 도메인별 상세 화면으로 이동합니다.

검색 대상​

도메인예시이동 대상
SITE / AREA / LINES1_LOTTE_CS_DJ_SITE대시보드, 에셋 트리, 모델
EQUIPMENT / ASSETASSET_LINE_01에셋 트리, 설비 상세
TAGTAG_EDGE_00303_90000태그, 데이터 조회, 트렌드
OPCOPC_MAIN_01연결 상세
EDGEEDGE-303엣지 상세
ALARM_CONFIG알람 설정 ID고급 EQL 알람
FLOW플로우 ID플로우 목록·편집
USER / SECURITY사용자·보안 정책 ID시스템·보안 관리
EMPLOYEE / CUSTOMER / PRODUCT생산 마스터 ID생산 관리 화면

검색 결과 사용​

동작결과
Ctrl+K / Cmd+K어떤 입력창에 포커스가 있어도 도메인 검색 다이얼로그를 엽니다.
도메인 칩 클릭해당 도메인만 필터링합니다.
ID 클릭ID 를 클립보드에 복사합니다.
상세 이동 버튼 클릭도메인별 상세 화면이나 목록 화면으로 이동합니다.
최근 검색어 클릭같은 키워드로 다시 검색합니다.

운영 중 알람 메시지나 진단 토스트에서 보이는 ID 를 바로 검색하면 원인 객체로 이동하는 시간이 크게 줄어듭니다.

좌측 메뉴 구조​

현재 좌측 메뉴는 서버웹의 통합 메뉴 렌더링 기준으로 다음 순서입니다. 메뉴 그룹명은 영어로 표시되고, 실제 메뉴명은 한국어 라벨로 표시됩니다.

Overview​

메뉴내부 URL용도
대시보드/map/index사이트 지도, 데이터 파이프라인, 플랫폼 헬스, 핵심 KPI
통계/statistics/index연간 히트맵과 선택일 운영 통계

Connectivity​

메뉴내부 URL용도
프로토콜/connect/indexOPC/PLC/Modbus/DB/API 등 데이터소스 등록
연결 상태/connect/status전체 연결의 정상·지연·이상·끊김·미연결 모니터링
엣지/edge/index현장 엣지 장비 상태와 상세 제어

Factory Model​

메뉴내부 URL용도
모델/model/index사이트·구역·라인·설비 계층 모델
에셋/asset/tree/index에셋 트리와 상세 속성
태그/tag/index수집 태그 정의와 상태
온톨로지/ontology/index의미 모델·관계 정의
메타데이터/metadata/index도메인별 확장 속성
기준정보/basedata/index운영 기준값과 공통 코드

Production​

메뉴내부 URL용도
고객/customer/index고객 마스터
제품/product/index제품 마스터
직원/employee/index작업자·담당자 정보
근무표/calendar/index시프트와 운영 일정
워크오더/order/index생산 작업지시

Equipment​

메뉴내부 URL용도
설비 목록/equipment/index설비 카드와 설비 단위 대시보드 진입
데이터 조회/asset/data/index에셋·태그별 수집 데이터 조회
타임라인 비교/timeline/index태그·설비 간 시간축 비교

ISO​

메뉴내부 URL용도
ISO 데이터/asset/plugin/indexOEE/RAM/EMS 계산을 위한 설비별 원천 데이터
ISO 분석/analysis/indexISO 22400 기반 KPI 분석

Data​

메뉴내부 URL용도
스트림/stream/index실시간 시계열 스트리밍 차트
트렌드/storage/index태그 시계열 트렌드와 샘플링 분석
스냅샷/snapshot/index간격별 시계열 스냅샷
데이터 출력/data/index태그 시계열 데이터 조회·CSV 출력
오브젝트 (BLOB)/blob/store이미지·문서·바이너리 파일 저장소

Alarm​

메뉴내부 URL용도
알람/alarm/index실시간 알람 목록. 좌측 메뉴에 정보·경고·심각 카운트 배지 표시
알람 고급검색/alarm/advsearch/index기간·태그·상태·우선순위 조건 검색
알람 시각화 분석/alarm/analysis/index매트릭스, 히트맵, 랭킹, 트렌드 분석
고급 EQL 알람/alarm/config/indexEQL 기반 알람 룰 설정

Visualization​

메뉴내부 URL용도
캔버스/canvas/indexSVG 기반 현장 모니터링 화면

Automation​

메뉴내부 URL용도
플로우/flow/index자동화 그래프 목록·편집. 좌측 메뉴에 에러 카운트 배지 표시
플로우 실행 이력/flow/log플로우 실행 로그와 실패 이력
EQL 쿼리/query/index실시간 이벤트 쿼리 실행
스테이트먼트/statement/index배포된 EQL statement 관리

별도 트리거 메뉴는 현재 통합 메뉴에서 비활성화되어 있습니다. 트리거는 플로우 그래프 내부 노드나 EQL 도움말 의 statement 맥락에서 다룹니다.

Standard​

메뉴내부 URL / 외부 포트용도
네임스페이스/uns/treeUnified Namespace 계층과 Kafka/MQTT/SparkplugB 토픽 미리보기
카탈로그/catalog/index데이터 카탈로그
OPC-UAhttp://[현재호스트]:12780OPC-UA 표준 도구를 새 창으로 엽니다.
AAS V3http://[현재호스트]:8091/ui/AAS V3 UI 를 새 창으로 엽니다.

System​

메뉴내부 URL / 외부 포트용도
사용자/user/index사용자 계정 관리
보안 정책/security/index비밀번호·접근 보안 정책
API 토큰/token/index외부 연동용 API 토큰
모니터링/monitoring/index인프라 헬스·파이프라인·엔진 메트릭
진단/diagnostic/index시스템 진단 이벤트
로그/log/index애플리케이션 로그
설정/config/index시스템 키-값 설정
환경정보/env/view프로퍼티별 환경 설정 조회
클러스터/cluster/index클러스터 노드 상태
HA/ha/index고가용성 구성 상태
감사/audit/index감사 로그

실시간 알림과 토스트​

우측 상단 토스트는 새 진단 이벤트나 설비 상태 변화를 짧게 보여 줍니다.

진단 · 192.168.0.41
설비 상태 변경 - 설비=[ASSET_DJ_M_16_2], RUN -> FAULT
항목의미
제목알림 종류와 발생 장비 또는 모듈
본문상태 변화, 알람 내용, 진단 메시지 요약
색상정보·경고·심각 수준에 따라 강조
후속 확인알람은 알람, 설비 상태는 설비, 시스템 이벤트는 진단 에서 추적

토스트는 신호입니다. 실제 조치 전에는 관련 화면에서 시간, 대상 ID, 상세 로그를 다시 확인하세요.

공통 화면 패턴​

상태 색상​

색상일반 의미예시
녹색정상연결 정상, 인프라 UP, 설비 건강 정상
주황주의·지연연결 지연, 경고 알람, 처리 지연
빨강이상·심각연결 이상, 심각 알람, 엔진 오류
회색미연결·미확인데이터 없음, 아직 수집 이력 없음

정확한 코드 의미는 상태 코드 정의 를 기준으로 확인합니다.

목록과 상세​

대부분의 업무 화면은 상단 검색 → 목록 테이블 → 행 클릭 상세 패턴을 사용합니다.

단계설명
검색 조건 선택기간, 사이트, 상태, 키워드, 표시 건수
조회현재 조건으로 목록 또는 카드 갱신
행 클릭해당 도메인의 상세 화면이나 드로어 열기
새로고침실시간 수치가 의심될 때 직전 조건으로 재조회

시간 범위​

알람·진단·로그·데이터 조회 화면은 빠른 시간 범위를 제공합니다.

버튼용도
10M / 30M방금 발생한 장애 추적
1H / 6H / 12H당일 교대 시간대 분석
ALL검색 조건 전체 기간 표시

권장 운영 동선​

교대 시작​

  1. 대시보드 에서 통신 연결률, 금일 수집, 금일 알람, 설비 가동률, 설비 가용률, OEE 를 확인합니다.
  2. 지도에서 빨강·주황 사이트 또는 연결 상태 칩이 있는지 확인합니다.
  3. 우측 헬스 레일에서 캐시, WS, MQTT, Kafka, 이벤트DB, 시계열 상태를 확인합니다.
  4. 일일 통계 에서 전일과 오늘의 수집량·알람량을 비교합니다.

알람 발생​

  1. 우측 상단 토스트 또는 알람 배지로 새 알람을 확인합니다.
  2. 알람 에서 기간과 사이트를 좁혀 상세를 엽니다.
  3. 태그·에셋 ID 를 도메인 검색에 넣어 설비·데이터 조회 화면으로 이동합니다.
  4. 반복 알람이면 고급 EQL 알람, 플로우, EQL 도움말 을 확인해 룰과 자동화 상태를 점검합니다.

연결 이상​

  1. 대시보드 의 연결률 카드 또는 지도 상태 칩을 클릭합니다.
  2. 연결 상태 에서 지연·이상·끊김 대상을 찾습니다.
  3. 엣지 장비 문제로 보이면 엣지 상세로 내려갑니다.
  4. 같은 시간대 진단 이벤트가 있는지 진단 에서 확인합니다.

권한과 메뉴 노출​

좌측 메뉴는 역할과 무관하게 모두 같습니다. 세 역할 모두 동일한 메뉴 목록을 봅니다.

권한 차이는 메뉴가 아니라 화면 안에서 나타납니다. 메뉴를 열 수는 있어도 조회·수정·삭제·제어가 역할과 서버 보안 정책에 따라 막힐 수 있습니다.

역할일반 범위
ADMIN전체 운영·설정·보안·시스템 관리
API외부 시스템 연동용 계정. 보안 정책을 함께 부여합니다
USER조회 중심. 변경 권한 없음

권한이 없어 기능이 막히는 경우에는 보안 관리자에게 역할 변경을 요청합니다. 자세한 계정 관리는 보안 관리 를 참고하세요.

자주 묻는 질문​

Q. 예전의 "요약" 메뉴가 안 보입니다.

A. 화면 개편 이후 첫 화면 메뉴명은 대시보드로 정리되었습니다. 내부 URL 은 /map/index 로 동일합니다.

Q. 도구 메뉴의 시계열 엔진·SQL 항목이 사라졌습니다.

A. 좌측 메뉴에서 새 창으로 열리는 외부 항목은 Standard 의 OPC-UA 와 AAS V3 둘뿐입니다. 일반 시계열 조회는 Data 그룹의 트렌드, 데이터 출력, 스냅샷 화면을 사용합니다.

Q. 메뉴는 보이는데 저장 버튼이 없거나 눌러도 막힙니다.

A. 메뉴 목록은 역할과 무관하게 모두 같게 표시되고, 실제로 할 수 있는 일은 화면 안에서 역할에 따라 갈립니다. 권한이 필요하면 보안 관리 담당자에게 역할 변경을 요청하세요.

Q. 상단 검색으로 데이터를 조회했는데 현재 테이블이 바뀌지 않습니다.

A. 상단 검색은 전역 도메인 이동용입니다. 현재 테이블을 필터링하려면 각 화면 본문 상단의 검색 폼을 사용하세요.

Q. 토스트가 사라졌는데 내용을 다시 볼 수 있나요?

A. 알람은 알람, 시스템 이벤트는 진단, 상세 애플리케이션 로그는 시스템 의 로그 화면에서 다시 조회합니다.

Q. 좌측 메뉴가 보이지 않습니다.

A. 상단 좌측의 메뉴 토글을 클릭하세요. 브라우저 폭이 좁으면 자동으로 접힌 상태일 수 있습니다.

관련 화면​