> 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/statistics.md).

# 일일 통계

## 목차

* [개요](#overview)
* [화면 구성](#layout)
* [상단 헤더와 연도 조회](#top-toolbar)
* [연간 시스템 가동률 히트맵](#annual-heatmap)
* [선택일 KPI 카드](#kpi-cards)
* [선택일 상세 차트](#detail-charts)
* [포인트·알람·레이턴시 트렌드](#point-alarm)
* [자산·OPC·사이트·태그 차트](#asset-charts)
* [엣지와 플로우 차트](#edge-flow)
* [이상 신호별 대응](#playbook)
* [자주 묻는 질문](#faq)
* [관련 화면](#related)

***

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

일일 통계 화면은 한 해의 일자별 운영 상태를 히트맵으로 보고, 특정 날짜를 선택해 그 날의 수집·알람·통신·설비·엣지·플로우 지표를 한 화면에서 분석하는 화면입니다.

**경로**: 왼쪽 메뉴 > **Overview > 일일 통계** (내부 URL `/statistics/index`)

현재 화면 제목은 `통계 · YYYY-MM-DD (어제)` 형태로 표시됩니다. 통계 집계 기준이 전일 데이터이기 때문에, 진입 시 기준 날짜도 어제로 안내됩니다.

***

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

```
┌──────────────────────────────────────────────────────────────┐
│ 통계 · YYYY-MM-DD (어제)                  [연도 ▼] [조회]   │
├──────────────────────────────────────────────────────────────┤
│ 연간 시스템 가동률                                           │
│ 날짜별 운영 현황 히트맵                                      │
├──────────────────────────────────────────────────────────────┤
│ KPI 8장: 가동률 / DB / 통신 / 진단 / 데이터 / 알람 / BLOB / 모델 │
├──────────────────────────────────────────────────────────────┤
│ 날짜 미선택: "히트맵에서 날짜를 선택해주세요"                 │
│ 날짜 선택 후: 상세 차트 영역 표시                            │
├──────────────────────────────────────────────────────────────┤
│ 포인트·알람·레이턴시·검증실패 4차트                           │
│ 자산·OPC·사이트·태그 16차트                                  │
│ 엣지 4차트 + 플로우 4차트                                    │
└──────────────────────────────────────────────────────────────┘
```

| 영역         | 표시                           |
| ---------- | ---------------------------- |
| **상단 헤더**  | 화면 제목, 연도 셀렉터, 조회 버튼         |
| **히트맵**    | 연간 시스템 가동률. 셀 클릭 시 선택일 상세 로드 |
| **KPI 카드** | 선택일 핵심 지표 8장과 전일 대비 델타       |
| **상세 차트**  | 포인트/알람, 자산/OPC, 엣지, 플로우 차트   |

***

## 상단 헤더와 연도 조회 <a href="#top-toolbar" id="top-toolbar"></a>

| 컨트롤        | 설명                             |
| ---------- | ------------------------------ |
| **연도 셀렉터** | 통계를 조회할 연도 선택. 기본값은 현재 연도      |
| **조회**     | 선택한 연도의 히트맵과 통계 데이터를 다시 불러옵니다. |

연도를 바꾼 뒤에는 반드시 **조회** 버튼을 눌러야 화면이 갱신됩니다.

***

## 연간 시스템 가동률 히트맵 <a href="#annual-heatmap" id="annual-heatmap"></a>

히트맵은 선택한 연도의 날짜별 시스템 가동률을 한 칸씩 표시합니다.

| 항목        | 설명                           |
| --------- | ---------------------------- |
| **차트 ID** | `heatmap_chart`              |
| **패널 제목** | 연간 시스템 가동률                   |
| **표시 단위** | 1일 = 1셀                      |
| **동작**    | 셀 클릭 시 하단 상세 차트가 선택일 기준으로 갱신 |

색이 짙고 안정적인 구간은 정상 운영일 가능성이 높습니다. 색이 약하거나 비어 있는 날은 데이터 미수집, 장애, 집계 누락 여부를 확인합니다.

***

## 선택일 KPI 카드 <a href="#kpi-cards" id="kpi-cards"></a>

히트맵에서 날짜를 선택하면 KPI 8장이 선택일 기준으로 갱신됩니다.

| 카드                | 의미                   |
| ----------------- | -------------------- |
| **시스템 가동률**       | 24시간 중 정상 운영 비율      |
| **DB 저장 용량**      | 시계열·이벤트 저장소 용량       |
| **통신**            | 정상 OPC 수와 전체 통신 상태   |
| **진단 경고/에러**      | 선택일 진단 WARN/ERROR 부담 |
| **총 데이터 수집**      | 선택일 수집 포인트 수         |
| **총 알람 건수**       | 선택일 알람 총량            |
| **BLOB 업로드**      | 선택일 파일 업로드 수         |
| **사이트 / 태그 / 설비** | 모델 규모와 등록 현황         |

각 카드에는 전일 대비 델타가 같이 표시됩니다. 수집량·가동률은 감소가 위험 신호이고, 알람·진단은 증가가 위험 신호입니다.

***

## 선택일 상세 차트 <a href="#detail-charts" id="detail-charts"></a>

날짜를 클릭하기 전에는 아래 안내가 표시됩니다.

```
히트맵에서 날짜를 선택해주세요.
```

날짜를 클릭하면 상세 영역이 펼쳐지고 다음 순서로 차트가 표시됩니다.

1. 포인트·알람·레이턴시·검증실패 4차트
2. 자산·OPC·사이트·태그 16차트
3. 엣지 4차트
4. 플로우 4차트

***

## 포인트·알람·레이턴시 트렌드 <a href="#point-alarm" id="point-alarm"></a>

| 패널                | 차트 ID                    | 용도                   |
| ----------------- | ------------------------ | -------------------- |
| **포인트 수신 트렌드**    | `report_point_chart`     | 시간대별 포인트 수신량         |
| **알람 우선순위별 트렌드**  | `report_alarm_chart`     | 정보·경고·심각 알람의 시간대별 변화 |
| **평균 레이턴시 트렌드**   | `report_latency_chart`   | 수집부터 저장까지 평균 지연      |
| **포인트 검증 실패 트렌드** | `trend_point_fail_chart` | 타입·범위·유효성 검증 실패      |

수집량이 떨어진 시간대와 알람·레이턴시가 오른 시간대가 겹치면 연결·엣지·저장소 병목을 함께 봐야 합니다.

***

## 자산·OPC·사이트·태그 차트 <a href="#asset-charts" id="asset-charts"></a>

| 패널                   | 차트 ID                          | 용도             |
| -------------------- | ------------------------------ | -------------- |
| **OPC 통신 연결 상태 분포**  | `opc_status_chart`             | 선택일 OPC 상태 분포  |
| **설비 건강 상태 분포**      | `asset_health_chart`           | 설비 건강 상태 분포    |
| **사이트별 데이터 수집 비교**   | `report_asset_top_chart`       | 사이트별 수집량 랭킹    |
| **태그별 포인트 수신 순위 10** | `report_tag_point_chart`       | 수신량 상위 태그      |
| **태그별 알람 순위 10**     | `report_tag_alarm_chart`       | 알람 상위 태그       |
| **사이트별 알람 분포**       | `site_alarm_chart`             | 사이트별 알람 비중     |
| **설비 연결 상태 분포**      | `asset_connection_chart`       | 설비 연결 상태 분포    |
| **데이터 유형별 수집 분포**    | `report_datatype_pie_chart`    | 타입별 수집 비중      |
| **OPC별 평균 레이턴시**     | `report_opc_latency_chart`     | 지연이 큰 OPC 식별   |
| **사이트별 알람 비교**       | `report_asset_top_alarm_chart` | 사이트별 알람 랭킹     |
| **사이트별 데이터 수집 분포**   | `site_data_chart`              | 사이트별 수집 비중     |
| **OPC 통신 연결 상태 트렌드** | `trend_opc_conn_chart`         | 시간대별 OPC 상태 변화 |
| **OPC 통신 지연 트렌드**    | `trend_opc_latency_chart`      | 시간대별 통신 지연     |
| **OPC 레이턴시 히스토그램**   | `opc_latency_chart`            | 지연 분포          |
| **라인별 데이터 수집**       | `report_line_point_chart`      | 라인별 수집량 비교     |
| **구역별 건강·연결 상태**     | `report_area_status_chart`     | 구역 단위 상태 비교    |

***

## 엣지와 플로우 차트 <a href="#edge-flow" id="edge-flow"></a>

### 엣지 4차트

| 패널            | 차트 ID                     | 용도                 |
| ------------- | ------------------------- | ------------------ |
| **엣지 헬스 시간별** | `edge_health_hour_chart`  | 엣지 건강 상태 시간 추이     |
| **엣지 API 호출** | `edge_stats_rest_chart`   | 서버에서 엣지로 호출한 부담    |
| **엣지 푸시 수신**  | `edge_stats_push_chart`   | 엣지에서 서버로 푸시한 수신 부담 |
| **엣지 헬스 분포**  | `edge_stats_health_chart` | 엣지 건강 상태 분포        |

### 플로우 4차트

| 패널              | 차트 ID                    | 용도                |
| --------------- | ------------------------ | ----------------- |
| **플로우 호출 순위 5** | `flow_top_called_chart`  | 호출량이 많은 플로우       |
| **플로우 에러 순위 5** | `flow_top_errored_chart` | 에러가 많은 플로우        |
| **플로우 시간별 추이**  | `flow_hour_trend_chart`  | 선택일 24시간 완료/에러 흐름 |
| **플로우 일별 추이**   | `flow_daily_trend_chart` | 최근 30일 완료/에러 흐름   |

***

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

| 증상          | 우선 확인                  | 후속 조치                                                                                                                 |
| ----------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------- |
| 가동률 급락      | 히트맵 색상, 시스템 가동률 카드     | [시스템](/plantpulse-platform/user/system.md), [진단](/plantpulse-platform/user/diagnostic.md) 로그 확인                       |
| 총 데이터 수집 급감 | 포인트 수신 트렌드, 사이트별 수집 비교 | [연결 상태](/plantpulse-platform/user/connection.md#status-screen), [엣지](/plantpulse-platform/user/connection.md#edge) 확인 |
| 알람 급증       | 알람 우선순위 트렌드, 태그별 알람 순위 | [알람](/plantpulse-platform/user/alarm.md) 에서 태그·사이트별 상세 확인                                                             |
| 레이턴시 증가     | 평균 레이턴시, OPC별 평균 레이턴시  | 네트워크, 엣지, 저장소 지연 분리                                                                                                   |
| 검증 실패 증가    | 포인트 검증 실패 트렌드          | 태그 데이터 타입·범위·수집 값 확인                                                                                                  |
| 플로우 에러 증가   | 플로우 에러 순위 5            | [플로우 실행 이력](/plantpulse-platform/user/flow.md) 확인                                                                     |

***

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

**Q. 날짜를 선택했는데 상세 차트가 비어 있습니다.**

A. 해당 날짜에 수집 데이터가 없거나 집계가 아직 완료되지 않았을 수 있습니다. [연결 상태](/plantpulse-platform/user/connection.md#status-screen) 와 [데이터 포인트](/plantpulse-platform/user/data-point.md) 에서 실제 인입 여부를 확인하세요.

**Q. 화면에 예전처럼 사이트 전체 요약 테이블이 보이지 않습니다.**

A. 현재 통계 화면은 히트맵, KPI 카드, 차트 그리드 중심으로 개편되었습니다. 사이트별 비교는 `사이트별 데이터 수집 비교`, `사이트별 알람 비교`, `사이트별 데이터 수집 분포` 차트를 사용하세요.

**Q. 시스템 기준 탭이 없습니다.**

A. 현재 화면은 별도 탭 없이 상세 차트를 한 흐름으로 펼칩니다. 시스템 자체 상태는 KPI 카드, 포인트·알람 트렌드, [시스템](/plantpulse-platform/user/system.md) 화면에서 함께 확인합니다.

**Q. 플로우 차트는 왜 통계 화면에 있나요?**

A. 플로우 실행량과 에러는 데이터 처리 자동화 상태를 보여 주는 운영 지표입니다. 데이터 수집 이상과 자동화 실패가 같은 시간대에 겹치는지 확인하는 데 유용합니다.

***

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

* [대시보드](/plantpulse-platform/user/summary.md) — 실시간 운영 홈과 KPI
* [연결 관리](/plantpulse-platform/user/connection.md) — 프로토콜, 연결 상태, 엣지
* [데이터 포인트](/plantpulse-platform/user/data-point.md) — 태그 데이터 트렌드 조회
* [알람](/plantpulse-platform/user/alarm.md) — 실시간 알람과 이력 검색
* [플로우](/plantpulse-platform/user/flow.md) — 자동화 그래프와 실행 이력
* [시스템](/plantpulse-platform/user/system.md) — 인프라 헬스와 로그
* [상태 코드 정의](/plantpulse-platform/user/status.md) — 연결·건강·알람 상태 해석