---
{"id":"telemetry","title":"사용량·차트·실시간 콘솔","category":"업무 패턴","order":76,"summary":"실시간처럼 보이는 것과 실제 수집된 값을 구분합니다.","status":"문서 기준 · UI 미검증","references":["patterns/status-indicator-pattern/index","patterns/loading-pattern/index"]}
---

# 사용량·차트·실시간 콘솔

## 데이터 계약

- DATA-01 MUST: 값·단위·집계 기간·수집 시각·출처를 구분합니다.
- DATA-02 MUST: 미수집·연결 실패를 0으로 표시하지 않습니다.
- DATA-03 MUST: 평균·최대·p95·할당량·현재 사용량을 같은 값처럼 바꾸어 표시하지 않습니다.
- DATA-04 SHOULD: 백그라운드 polling은 숨긴 탭·속도 제한·네트워크 상태를 고려합니다.
- DATA-05 MUST: 오래된 값을 유지하면 현재값과 구분할 수 있게 합니다.
- DATA-06 MUST: 그래프의 색만으로 시리즈를 구별하지 않고 범례·단위·대체 값을 제공합니다.
- DATA-07 MUST: 콘솔의 사용자 입력과 출력은 원래 스트림/권한 소유자를 유지하고 비밀값이 문서 캡처에 포함되지 않게 합니다.

## 실제 확인과 남은 일

Panel ServerRow 소스의 interval은 60000ms입니다. 숨긴 탭은 조회를 생략하고 429는 이전 정상값을 유지합니다. 기존 ARCT 문서의 후반부에는 30초·실패 시 초기화 설명이 남아 있어 현재 소스와 충돌합니다. 이 문서는 60초 소스 기록을 기준으로 하며 화면에 freshness가 명확히 표시되는지는 미검증입니다.

## 예시

좋음: “메모리 2.1 GiB / 4 GiB · 1분 전 수집”.
피함: 서버 연결이 끊겼는데 0 GiB·정상으로 표시.

## 검증

WebSocket 연결·중단·재연결, 지연 응답, 429, 일부 지표 누락, 데이터 기간 변경, 0과 null, 축 단위, 키보드 콘솔 이탈 경로를 확인합니다.