> For the complete documentation index, see [llms.txt](https://kopens.gitbook.io/plantpulse-platform/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kopens.gitbook.io/plantpulse-platform/user/summary.md).

# 대시보드

## 목차

* [개요](#overview)
* [화면 구성](#layout)
* [상단 페이지 헤더](#page-header)
* [글로벌 사이트 맵](#site-map)
* [데이터 파이프라인 카드](#pipeline)
* [사이트 규모·연결 상태 요약](#site-summary)
* [우측 헬스 레일](#health-rail)
* [플랫폼 핵심 지표](#kpi)
* [하단 운영 위젯](#bottom-widgets)
* [주요 드릴다운](#drilldown)
* [이상 신호별 대응](#playbook)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

## 개요 <a href="#overview" id="overview"></a>

대시보드는 로그인 후 가장 먼저 확인하는 운영 홈 화면입니다. 좌측 메뉴에서는 **OVERVIEW > 대시보드**로 표시되며 내부 URL 은 `/map/index` 입니다.

이 화면은 사이트 지도, 데이터 파이프라인, 인프라 헬스, 클러스터 상태, 핵심 KPI 를 한 화면에 모아 운영자가 다음 질문에 빠르게 답할 수 있도록 구성되었습니다.

* 어느 사이트나 라인에서 이상 신호가 발생했는가
* 데이터 수집·수신·처리·저장 파이프라인이 막히지 않았는가
* 캐시, WS, MQTT, Kafka, 이벤트DB, 시계열 엔진이 정상인가
* 금일 수집량, 알람, 설비 가동률, OEE 가 평소 범위인가

> 예전 문서에서 "요약"이라고 부르던 첫 화면은 현재 UI 에서 **대시보드**로 정리되었습니다. URL 은 기존과 동일하게 `/map/index` 입니다.

***

## 화면 구성 <a href="#layout" id="layout"></a>

```
┌────────────────────────────────────────────────────────────────────┐
│ 상단 바: 메뉴 토글 / 도메인 검색 / LIVE / 알람 / 전체화면 / 설정 / 매뉴얼 / 사용자 │
├────────────────────────────────────────────────────────────────────┤
│ 한국핵심산업                                                        │
│ 플랫폼 요약 - 사이트별 운영·성능 통합 모니터링                       │
├──────────────────────────────────────────────────────────┬─────────┤
│ 글로벌 사이트 맵                                         │ 우측     │
│  ┌ 데이터 파이프라인: 수집 → 수신 → 처리 → 버퍼 → 저장 ┐  │ 헬스     │
│  │ 사이트 마커 / 지도 확대·축소 / 좌표 표시              │  │ 레일     │
│  │ 사이트·구역·라인·설비·태그 카운트                    │  │         │
│  │ 연결 상태 칩: 정상·지연·이상·끊김·안됨                │  │         │
│  └────────────────────────────────────────────────────┘  │         │
├────────────────────────────────────────────────────────────────────┤
│ 플랫폼 핵심 지표: 통신 연결률 / 금일 수집 / 금일 알람 / 가동률 / 가용률 / OEE │
├────────────────────────────────────────────────────────────────────┤
│ 하단 위젯: 사이트 목록 / 포인트·알람 / OPC / 설비 / 생산 / 엣지 / 플로우 / 진단 │
└────────────────────────────────────────────────────────────────────┘
```

| 영역            | 표시 내용                                                |
| ------------- | ---------------------------------------------------- |
| **상단 페이지 헤더** | 회사명, "플랫폼 요약 - 사이트별 운영·성능 통합 모니터링" 설명                |
| **글로벌 사이트 맵** | 사이트 위치, 마커 상태, 지도 조작, 좌표 표시                          |
| **데이터 파이프라인** | 수집·수신·처리·버퍼·저장 단계별 처리량과 상태                           |
| **사이트 규모 요약** | 사이트, 구역, 라인, 설비, 태그 수                                |
| **연결 상태 요약**  | 정상연결, 연결지연, 연결이상, 연결끊김, 연결안됨 카운트                     |
| **우측 헬스 레일**  | 플랫폼 헬스 타임라인, 시스템 성능, 클러스터 상태, 인프라/엔진 상태              |
| **핵심 KPI**    | 통신 연결률, 금일 수집, 금일 알람, 설비 가동률, 설비 가용률, 종합 OEE         |
| **하단 운영 위젯**  | 사이트 목록, 포인트·알람 트렌드, OPC/설비 상태, 생산 일정·워크오더, 엣지·플로우·진단 |

***

## 상단 페이지 헤더 <a href="#page-header" id="page-header"></a>

본문 상단에는 현재 운영 조직 또는 사이트 그룹명이 크게 표시됩니다.

| 항목         | 설명                                |
| ---------- | --------------------------------- |
| **회사명**    | 예: `한국핵심산업`                       |
| **보조 설명**  | `플랫폼 요약 - 사이트별 운영·성능 통합 모니터링`     |
| **실시간 알림** | 설비 상태 변경, 진단 이벤트 등이 우측 상단 토스트로 표시 |

상단의 전역 검색과 알림 사용법은 [콘솔 탐색과 공통 화면](/plantpulse-platform/user/navigation.md) 을 참고하세요.

***

## 글로벌 사이트 맵 <a href="#site-map" id="site-map"></a>

지도는 등록된 사이트 위치와 운영 상태를 동시에 보여 줍니다. 사이트 마커는 공장 아이콘으로 표시되며, 마커 라벨에는 사이트 ID 또는 짧은 이름이 표시됩니다.

### 지도 조작

| 동작     | 방법                          |
| ------ | --------------------------- |
| 확대/축소  | 지도 좌측 `+` / `-` 버튼 또는 마우스 휠 |
| 이동     | 지도 드래그                      |
| 사이트 확인 | 사이트 마커 클릭                   |
| 좌표 확인  | 지도 하단의 위도/경도 표시             |

### 마커 해석

| 상태  | 의미                     | 다음 확인                                                                                                    |
| --- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| 정상  | 사이트의 주요 연결과 데이터 인입이 정상 | KPI 와 수집량만 확인                                                                                            |
| 주의  | 일부 연결 지연 또는 설비 경고      | [연결 상태](/plantpulse-platform/user/connection.md#status-screen), [알람](/plantpulse-platform/user/alarm.md) |
| 이상  | 연결 이상·심각 알람·데이터 급감 가능  | [진단](/plantpulse-platform/user/diagnostic.md), [엣지 게이트웨이](/plantpulse-platform/user/connection.md#edge)  |
| 미확인 | 좌표 또는 수집 이력이 부족        | [팩토리 관리](/plantpulse-platform/user/factory.md), [데이터 포인트](/plantpulse-platform/user/data-point.md)       |

***

## 데이터 파이프라인 카드 <a href="#pipeline" id="pipeline"></a>

지도 위에는 플랫폼의 데이터 처리 흐름이 카드 형태로 표시됩니다.

```
수집 ─→ 수신 ─→ 처리 ─→ 버퍼 ─→ 저장
```

| 단계     | 대표 지표 | 정상 해석              |
| ------ | ----- | ------------------ |
| **수집** | Hz    | 현장 수집 루프가 살아 있는지   |
| **수신** | PPS   | 서버가 초당 받는 포인트 수    |
| **처리** | 작업자 수 | 파이프라인 워커가 정상 동작하는지 |
| **버퍼** | 대기 큐  | 큐 적체가 없는지          |
| **저장** | 저장 건수 | 시계열·이벤트 저장이 누적되는지  |

각 카드 하단의 작은 스파크라인은 최근 변화 추이를 보여 줍니다. 값이 0으로 떨어지거나 버퍼만 계속 증가하면 데이터 인입 또는 저장 병목을 의심합니다.

***

## 사이트 규모·연결 상태 요약 <a href="#site-summary" id="site-summary"></a>

지도 좌측 하단에는 현재 모델 규모와 연결 상태가 요약됩니다.

### 모델 규모

| 항목      | 의미              |
| ------- | --------------- |
| **사이트** | 등록된 공장 또는 사업장 수 |
| **구역**  | 사이트 하위 운영 구역 수  |
| **라인**  | 생산 라인 수         |
| **설비**  | 등록된 설비 수        |
| **태그**  | 수집·계산·상태 태그 수   |

모델 규모가 기대값과 다르면 [팩토리 관리](/plantpulse-platform/user/factory.md) 에서 사이트·에셋·태그 등록 상태를 확인합니다.

### 연결 상태 칩

| 칩        | 의미                 | 우선순위          |
| -------- | ------------------ | ------------- |
| **정상연결** | 최근 데이터 수신 정상       | 참고            |
| **연결지연** | 수신 지연 발생           | 당일 추이 확인      |
| **연결이상** | 기준 시간 이상 미수신 또는 오류 | 즉시 점검         |
| **연결끊김** | 장시간 미수신            | 현장·엣지·네트워크 확인 |
| **연결안됨** | 아직 수신 이력 없음        | 등록·시운전 상태 확인  |

정확한 상태 기준은 [상태 코드 정의](/plantpulse-platform/user/status.md) 를 기준으로 합니다.

***

## 우측 헬스 레일 <a href="#health-rail" id="health-rail"></a>

대시보드 우측 레일은 플랫폼 자체의 건강 상태를 빠르게 보여 줍니다. 운영자가 사이트 이상과 시스템 이상을 구분하는 데 사용합니다.

### 플랫폼 헬스 타임라인

| 항목          | 설명                       |
| ----------- | ------------------------ |
| **최근 시각**   | 마지막 집계 시각                |
| **컬러 타임라인** | 시간대별 정상·주의·이상 상태         |
| **용도**      | 특정 시간대에 시스템 상태가 흔들렸는지 확인 |

타임라인에 주황·빨강 구간이 집중되면 같은 시간대의 [진단](/plantpulse-platform/user/diagnostic.md) 로그와 [시스템](/plantpulse-platform/user/system.md) 로그를 확인합니다.

### 시스템 성능

| 게이지        | 의미              | 점검 기준                 |
| ---------- | --------------- | --------------------- |
| **CPU 부하** | 서버 CPU 사용률      | 장시간 80% 이상이면 부하 원인 확인 |
| **메모리 사용** | JVM/시스템 메모리 사용률 | 지속 상승이면 메모리 압박 확인     |
| **HDD 점유** | 데이터 저장소 사용률     | 85% 이상이면 정리·증설 검토     |

### 클러스터 상태

| 항목                  | 의미                |
| ------------------- | ----------------- |
| **상태**              | 클러스터 노드 역할과 정상 여부 |
| **모드**              | 단일/마스터/워커 등 운영 모드 |
| **읽기/쓰기 지연**        | 저장소 응답 지연         |
| **CPU / 메모리 / 데이터** | 클러스터 자원 사용량       |
| **마지막 업데이트**        | 클러스터 상태 집계 시각     |

### 인프라와 엔진 상태

| 영역      | 항목                              |
| ------- | ------------------------------- |
| **인프라** | 캐시, WS, MQTT, Kafka, 이벤트DB, 시계열 |
| **엔진**  | 수집·처리·지연·저장 관련 실시간 지표           |

인프라 항목이 하나라도 비정상이면 사이트 단위 문제보다 플랫폼 공통 문제일 가능성이 큽니다. 먼저 [시스템](/plantpulse-platform/user/system.md#monitoring) 과 [진단](/plantpulse-platform/user/diagnostic.md) 을 확인합니다.

***

## 플랫폼 핵심 지표 <a href="#kpi" id="kpi"></a>

대시보드 하단에는 운영 판단에 필요한 6개 KPI 카드가 표시됩니다.

| KPI        | 의미                | 클릭 후 확인                                                                                                      |
| ---------- | ----------------- | ------------------------------------------------------------------------------------------------------------ |
| **통신 연결률** | 정상 연결 수 / 전체 연결 수 | [연결 상태](/plantpulse-platform/user/connection.md#status-screen)                                               |
| **금일 수집**  | 오늘 수집된 데이터 포인트 건수 | [데이터 포인트](/plantpulse-platform/user/data-point.md), [일일 통계](/plantpulse-platform/user/statistics.md)         |
| **금일 알람**  | 오늘 발생한 알람 총 건수    | [알람](/plantpulse-platform/user/alarm.md)                                                                     |
| **설비 가동률** | 데이터 인입이 정상인 설비 비율 | [설비](/plantpulse-platform/user/equipment.md), [연결 상태](/plantpulse-platform/user/connection.md#status-screen) |
| **설비 가용률** | 건강 진단이 정상인 설비 비율  | [설비](/plantpulse-platform/user/equipment.md), [진단](/plantpulse-platform/user/diagnostic.md)                  |
| **종합 OEE** | 전체 설비 종합효율        | [생산 관리](/plantpulse-platform/user/production.md), [ISO 분석](/plantpulse-platform/user/plugins.md)             |

KPI 카드는 값 하나만 보는 화면이 아닙니다. 값이 평소 범위에서 벗어나면 카드의 관련 화면으로 내려가 **어느 사이트·라인·설비·태그가 원인인지** 좁혀야 합니다.

***

## 하단 운영 위젯 <a href="#bottom-widgets" id="bottom-widgets"></a>

지도와 KPI 아래에는 선택한 사이트가 아니라 **플랫폼 전체의 당일 운영 흐름**을 보는 위젯들이 이어집니다.

| 위젯               | 표시                                             | 이동                                                                                               |
| ---------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------ |
| **사이트 목록**       | 연결 상태, 건강 상태, 사이트 ID/명, 24시간 데이터 추세, 금일 데이터·알람 | 사이트명 클릭 시 에셋 트리                                                                                  |
| **데이터 포인트 및 알람** | 최근 24시간 포인트 수신·알람 추세                           | [트렌드](/plantpulse-platform/user/data-point.md#trend), [알람](/plantpulse-platform/user/alarm.md)   |
| **알람 통계**        | 금일 알람 합계, 우선순위·ON/OFF 분포                       | [알람 시각화 분석](/plantpulse-platform/user/alarm.md#analysis)                                         |
| **OPC 트렌드**      | 통신 연결 상태, 통신 지연 상태                             | [연결 상태](/plantpulse-platform/user/connection.md#status-screen)                                   |
| **설비 상태**        | 설비 연결 히트맵, 설비 건강 히트맵                           | [에셋](/plantpulse-platform/user/factory.md), [설비](/plantpulse-platform/user/equipment.md)         |
| **생산 정보**        | 금일 근무표, 금일 워크오더, OEE 추세·비교                     | [생산 관리](/plantpulse-platform/user/production.md), [ISO 분석](/plantpulse-platform/user/plugins.md) |
| **엣지**           | 엣지 헬스 시간별, 엣지 API 호출, 엣지 푸시 수신, 엣지 상태 분포       | [엣지](/plantpulse-platform/user/connection.md#edge)                                               |
| **플로우**          | 호출 TOP 5, 에러 TOP 5, 시간별 실행 추세                  | [플로우](/plantpulse-platform/user/flow.md)                                                         |
| **진단 사이드바**      | 엣지 히트맵, 플로우 건강 히트맵, 진단 INFO/WARN/ERROR 목록      | [진단](/plantpulse-platform/user/diagnostic.md), [시스템 로그](/plantpulse-platform/user/system.md#log) |

하단 위젯은 문제의 "범위"를 좁히는 데 유용합니다. 예를 들어 금일 수집량이 줄었으면 사이트 목록 → OPC 트렌드 → 설비 히트맵 순서로 내려가면 어느 계층에서 멈췄는지 빠르게 찾을 수 있습니다.

***

## 주요 드릴다운 <a href="#drilldown" id="drilldown"></a>

| 출발점     | 다음 화면                                                                                                | 목적                       |
| ------- | ---------------------------------------------------------------------------------------------------- | ------------------------ |
| 지도 마커   | [팩토리 관리](/plantpulse-platform/user/factory.md), [설비](/plantpulse-platform/user/equipment.md)         | 사이트·라인·설비 구조 확인          |
| 연결 상태 칩 | [연결 상태](/plantpulse-platform/user/connection.md#status-screen)                                       | 끊김·지연 데이터소스 식별           |
| 엣지 이상   | [엣지 게이트웨이](/plantpulse-platform/user/connection.md#edge)                                             | 엣지 장비 자원·PLC 수집 상태 확인    |
| 알람 토스트  | [알람](/plantpulse-platform/user/alarm.md)                                                             | 알람 발생 태그·자산·시간 확인        |
| 진단 토스트  | [진단](/plantpulse-platform/user/diagnostic.md)                                                        | 시스템 이벤트 원인 추적            |
| 수집량 급감  | [일일 통계](/plantpulse-platform/user/statistics.md), [데이터 포인트](/plantpulse-platform/user/data-point.md) | 어느 사이트·태그에서 데이터가 줄었는지 비교 |
| OEE 하락  | [생산 관리](/plantpulse-platform/user/production.md), [ISO 분석](/plantpulse-platform/user/plugins.md)     | 워크오더·가동률·성능·품질 원인 분해     |

***

## 이상 신호별 대응 <a href="#playbook" id="playbook"></a>

| 증상             | 우선 확인                                                                   | 일반 조치                                                                              |
| -------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| 통신 연결률 급락      | 연결 상태 칩, [연결 상태](/plantpulse-platform/user/connection.md#status-screen) | 끊긴 OPC/엣지 식별, 네트워크·수집 프로세스 확인                                                      |
| 금일 수집이 0 또는 급감 | 데이터 파이프라인 수집·수신 카드                                                      | 엣지 수집, MQTT/Kafka, 저장소 순서로 확인                                                      |
| 버퍼 대기 증가       | 파이프라인 버퍼 카드, 우측 엔진 지표                                                   | 저장소 지연, 외부 시스템 호출 지연, 워커 수 확인                                                      |
| 인프라 항목 비정상     | 우측 인프라 레일                                                               | [시스템](/plantpulse-platform/user/system.md#monitoring) 에서 캐시/WS/MQTT/Kafka/DB 상태 확인 |
| 심각 알람 증가       | 알람 KPI, 알람 토스트                                                          | [알람](/plantpulse-platform/user/alarm.md) 에서 태그·자산·우선순위별로 정렬                        |
| 설비 가용률 하락      | 설비 가용률 카드                                                               | 설비 건강 상태, 진단 로그, 최근 정비 이력 확인                                                       |
| OEE 하락         | 종합 OEE 카드                                                               | 가동률·성능·품질 중 하락한 축을 [ISO 분석](/plantpulse-platform/user/plugins.md) 에서 확인            |

***

## 자주 묻는 질문 <a href="#faq" id="faq"></a>

**Q. 대시보드 숫자가 멈춘 것 같습니다.** A. 상단 LIVE 상태가 녹색인지 확인하세요. 회색이거나 시간이 멈춰 있으면 브라우저 새로고침으로 재연결하고, 반복되면 [진단](/plantpulse-platform/user/diagnostic.md) 을 확인합니다.

**Q. 지도에 사이트 마커가 표시되지 않습니다.** A. 사이트에 위도·경도가 등록되어 있어야 합니다. [팩토리 관리](/plantpulse-platform/user/factory.md) 에서 사이트 좌표와 모델 등록 상태를 확인하세요.

**Q. 연결률은 낮은데 엣지는 정상으로 보입니다.** A. 엣지 장비의 HTTP 상태와 태그 데이터 수신 상태는 다를 수 있습니다. [연결 상태](/plantpulse-platform/user/connection.md#status-screen) 에서 실제 수신 지연·끊김 대상을 확인하세요.

**Q. 우측 헬스 레일의 인프라가 전부 정상인데 사이트 하나만 이상합니다.** A. 플랫폼 공통 장애보다는 해당 사이트의 네트워크, 엣지, OPC/PLC 연결 문제일 가능성이 큽니다. 사이트 마커와 [연결 상태](/plantpulse-platform/user/connection.md#status-screen) 를 먼저 확인합니다.

**Q. 알람 토스트가 사라졌습니다. 다시 볼 수 있나요?** A. [알람](/plantpulse-platform/user/alarm.md) 에서 최근 시간 범위를 `10M` 또는 `30M` 으로 좁혀 확인하세요. 시스템 이벤트라면 [진단](/plantpulse-platform/user/diagnostic.md) 에서 같은 시간대를 조회합니다.

***

## 관련 화면 <a href="#related" id="related"></a>

* [콘솔 탐색과 공통 화면](/plantpulse-platform/user/navigation.md) — 좌측 메뉴, 상단 검색, 공통 패턴
* [일일 통계](/plantpulse-platform/user/statistics.md) — 날짜별 운영 통계와 비교 분석
* [연결 관리](/plantpulse-platform/user/connection.md) — 프로토콜, 연결 상태, 엣지 게이트웨이
* [알람](/plantpulse-platform/user/alarm.md) — 실시간 알람과 이력 검색
* [설비 관리](/plantpulse-platform/user/equipment.md) — 설비 목록과 설비 단위 대시보드
* [데이터 포인트](/plantpulse-platform/user/data-point.md) — 태그별 원천 데이터 조회
* [진단](/plantpulse-platform/user/diagnostic.md) — 시스템 진단 이벤트
* [시스템](/plantpulse-platform/user/system.md) — 인프라 헬스, 로그, 설정, 환경정보
* [상태 코드 정의](/plantpulse-platform/user/status.md) — 연결·건강·알람·생산 상태 코드