H21. TV 월보드로 상황판 만들기
Diátaxis: How-to(목표별 가이드) · 대상: 운영자·관리자 — 보는 데 특별한 권한은 필요하지 않고, 볼 수 있는 그룹은 본인 권한을 따릅니다 ← 목차로
TV 월보드는 모니터링 현황을 TV·대형 모니터에 띄워 두고 여러 사람이 함께 보는 화면입니다. 콘솔이 "찾아 들어가는 화면"이라면, 월보드는 3m 밖에서 지나가며 읽는 화면입니다. 그래서 숫자를 빽빽하게 늘어놓지 않고, 큰 숫자 하나와 움직임으로 상태를 말합니다.
여는 법 — 상단 헤더(톱바)의 TV 아이콘을 누릅니다. 어느 화면에서든 보입니다.
- 새 창으로 열립니다(탭이 아닙니다). 브라우저가 팝업을 막으면 새 탭으로 열립니다.
- 지금 콘솔에서 보고 있는 애플리케이션 그룹을 그대로 가져갑니다.
- 무인 TV에 상시 표시할 때는 브라우저를 키오스크 모드(
--kiosk또는--app=<주소>)로 띄우면 주소 표시줄 없이 화면만 채웁니다.
참고 월보드는 다크 화면 전용입니다. TV에 계속 띄워 두는 화면이라 밝은 배경은 모니터 번인(화면 잔상)을 일으키기 때문입니다. 콘솔의 테마 설정과 무관하게 항상 어둡습니다.
화면 구성
한 칸(타일)은 애플리케이션 그룹 하나를 보여줍니다.
| 영역 | 무엇 |
|---|---|
| 가운데(히어로) | 큰 숫자 + 움직이는 그림 — 이 화면의 본체입니다 |
| 제목 | 보고 있는 애플리케이션 그룹 이름. 눌러서 다른 그룹으로 바꿉니다 |
| 히어로 아래 요약 | 진행 중 48건 중 11건 지연 처럼 한 줄로 |
| 왼쪽 사이드바 | 사용자 만족도(APDEX) · 활성 사용자 · 로그인 사용자 · 오류율 |
| 오른쪽 사이드바 | 등급 분포 · 초당처리수(TPS) · 평균 응답시간 |
| 상단 | LIVE 표시 · 시각 · 전체화면 · 설정(톱니) |
칸이 작아지면(6·8분할) 좌우 사이드바가 접히고 한 줄 요약만 남습니다. 화면이 좁아도 히어로 숫자와 요약은 끝까지 살아남습니다 — 3m 밖에서 읽어야 하는 것이 그 둘이기 때문입니다.
히어로 숫자 읽기 — 가장 먼저 볼 것
가운데 큰 숫자는 지연 트랜잭션 건수입니다. 그룹 안에서 가장 나쁜 상태를 보여줍니다.
숫 자 색이 상태를 말합니다.
| 색 | 뜻 | 기본 기준 |
|---|---|---|
| 초록 | 정상 | 주의 기준 미만 |
| 주황 | 주의 | 30건 이상 |
| 빨강 | 위험 | 50건 이상 |
중요 이 기준은 업무마다 달라야 합니다. 평소에도 40건이 밀려 있는 업무라면 기본값으로 두었을 때 화면이 늘 주황이고, 그러면 정작 나빠졌을 때 아무도 알아채지 못합니다. 경고가 배경이 되면 경고가 아닙니다. 설정에서 그 업무의 평상시보다 위에 맞추세요.
3색이 두 곳에 있습니다 — 서로 다른 것입니다
초록·주황·빨강이 두 군데 나오는데 말하는 것이 다릅니다. 헷갈리기 쉬운 부분입니다.
| 어디 | 무엇을 나누나 |
|---|---|
| 히어로 둘레의 호(弧) | 트랜잭션 상태 — 정상 / 지연 / 대기 |
| 오른쪽 사이드바의 '등급 분포' 카드 | 사용자 체감(아프덱스) — 만족 / 보통 / 불만 |
히어로 둘레의 호는 건수가 적을 때 건수에 비례해 늘어나고, 일정 수를 넘으면 비율로 바뀝니다. 그래서 "0건인데 초록이 가득" 같은 오해가 생기지 않습니다 — 없으면 짧습니다.
등급 분포 카드는 응답이 얼마나 빨랐는지를 사람이 느끼는 기준으로 나눈 것입니다. 지연 건수가 적어도 여기 '불만'이 많다면, 건수는 적은데 느린 요청이 섞여 있다는 뜻입니다.
히어로 오브젝트 6종 — 무엇을 고를까
여섯 가지 중 하나를 고릅니다. 어느 것을 골라도 숫자와 판정은 같습니다. 다른 것은 "상태를 어떤 움직임으로 말하는가" 뿐입니다.
| 이름 | 어떻게 보이나 |
|---|---|
| 코어 리액터 | 가운데 구(球)에서 입자가 돌고, 나빠지면 격해집니다 |
| 오비탈 게이트 | 고리를 지나는 흐름. 막히면 고리가 밝아지고 파문이 퍼집니다 |
| 펄스 필드 | 점들이 물결처럼 오르내립니다. 지연이 쌓이면 가운데부터 얼어붙고, 바깥 물결은 빨라집니다 |
| 침수 필드 | 물이 차오르는 면. 지연이 쌓이면 수위가 올라오고 파도가 빨라집니다 |
| 펄스 코어 | 사방에서 중심으로 흘러드는 입자. 밀리면 둘레에 띠가 생깁니다 |
| 하트비트 | 심장 박동처럼 뛰고, 박자에 맞춰 알갱이가 퍼져 나갑니다 |
색이 아니라 움직임으로 읽습니다
이 화면에서 가장 중요한 읽는 법입니다.
나빠질수록 빨라지고, 커지고, 불규칙해집니다. 색은 마지막 확인일 뿐입니다.
- 속도 — 정상일 때는 느긋합니다. 지연이 늘면 눈에 띄게 빨라집니다.
- 크기·양 — 밀린 것이 많을수록 입자가 많아지고 형태가 커집니다.
- 규칙성 — 평온할 때는 박자가 고릅니다. 나빠지면 흔들리고 튑니다.
왜 이렇게 만들었나 색만으로 말하면 정상일 때도 화려해서 장애와 구분되지 않습니다. 3m 밖에서 지나가는 사람이 알아채야 하는 것은 "빨간색이 있다"가 아니라 "평소와 다르다" 입니다. 그래서 정상 상태를 일부러 조용하게 만들었습니다.
화면 분할 — 여러 그룹을 한 화면에
한 화면을 1 / 2 / 3 / 4 / 6 / 8칸으로 나눠 칸마다 다른 애플리케이션 그룹을 띄웁니다.
- 설정(톱니) ▸ 화면 구성 ▸ 화면 분할에서 칸 수를 고릅니다.
- 각 칸의 제목을 눌러 그 칸이 볼 그룹을 고릅니다. 목록이 길면 검색할 수 있습니다.
- 칸의 톱니로 그 칸만 다른 히어로로 바꿀 수 있습니다.
고른 값은 칸별로 저장되어 다음에 열 때 그대로 복원됩니다.
참고 다음 경우에는 분할을 고를 수 없거나 자동으로 줄어듭니다.
- 칸이 너무 작아지는 화면 크기 — "이 화면 크기에서는 칸이 너무 작습니다"라고 알려 줍니다. 3m 밖에서 안 읽히는 크기는 아예 만들지 않습니다.
- 애플리케이션 그룹 수가 부족할 때 — 있는 그룹 수까지만 나눕니다.
화면이 작아 자동으로 줄어들어도 고른 값은 지워지지 않습니다. 큰 TV에서 다시 열면 원래 고른 칸 수로 돌아옵니다.
주소(URL)로 지정하기
무인 TV처럼 정해진 화면을 자동으로 띄워야 할 때는 주소에 조건을 담습니다.
| 파라미터 | 뜻 |
|---|---|
?split=N | 칸 수 |
?group=<그룹명> | 1칸일 때 볼 그룹 |
?groups=<그룹1,그룹2,…> | 칸별 그룹(쉼표로 구분) |
?hero=<이름> · ?heroes=<이름1,이름2,…> | 히어로 지정 |
설정
톱니 아이콘을 누르면 설정이 열리고, 세 묶음으로 나뉩니다.
| 묶음 | 항목 |
|---|---|
| 화면 구성 | 화면 분할 · 사이드바 화면(기본 / 상세 / 없음) · 사이드바 위치 · 가운데 화면(히어로 고르기) |
| 경고 기준 | 주의 건수 · 위험 건수 — 10 단위로 조정 |
| 모양 | 그래프 색 · 트랜잭션 볼 표시·크기·색 · 로그인 사용자 표시 |
- 경고 기준은 10 단위로만 조정합니다. 3m 밖에서 보는 화면의 판정 기준이라 1 단위의 정밀함은 뜻이 없고, 버튼 두 개로 끝나 무인 TV 앞에서도 조정할 수 있습니다.
- 트랜잭션 볼(요청이 날아가는 애니메이션)은 6·8분할에서 자동으로 꺼집니다 — 칸이 작아지면 볼이 보이지도 않으면서 그리는 비용만 들기 때문입니다.
- 기본값으로 되돌리기는 화면 구성을 제외한 나머지를 되돌립니다. 짜 둔 분할과 그룹 배치까지 사라지면 곤란하기 때문입니다.
연결이 끊겼을 때
월보드는 오래 켜 두는 화면이라, 끊김을 숨기지 않고 알립니다.
- 연결이 끊기면 마지막 화면을 그대로 두고 갱신만 멈춥니다. 화면이 비거나 0으로 떨어지지 않습니다 — 그러면 "장애"로 잘못 읽히기 때문입니다.
- 상단의 LIVE 표시가 바뀌고, 눌러서 다시 연결할 수 있습니다.
- 로그인이 만료되면 안내 띠가 뜨고 새로고침 버튼으로 되살립니다.
참고 표시가 멈춘 것과 실제로 값이 0인 것은 다릅니다. LIVE 표시부터 확인하세요.
표시 언어와 이름
- 콘솔에서 고른 표시 언어(한국어/영어)를 따라갑니다.
- 그룹·인스턴스에 표시 이름(별칭)을
지정해 두었다면 월보드에도 그 이름으로 나옵니다. 벽에 걸어 두고 여러 사람이 보는 화면이라
prod-order-was-01보다 업무명이 훨씬 잘 읽힙니다.
잘 안될 때
| 증상 | 점검 |
|---|---|
| TV 버튼을 눌러도 안 열림 | 브라우저 팝업 차단을 확인 — 차단되면 새 탭으로 열립니다 |
| 원하는 분할을 고를 수 없음 | 화면 크기가 작아 칸이 너무 작아지거나, 애플리케이션 그룹 수가 부족한 경우입니다 |
| 화면이 멈춘 것 같음 | 상단 LIVE 표시 확인 → 눌러서 다시 연결. 로그인 만료 띠가 있으면 새로고침 |
| 숫자가 늘 주황·빨강 | 그 업무의 평상시 지연 건수보다 경고 기준이 낮습니다 — 설정 ▸ 경고 기준에서 올리세요 |
| 그룹이 목록에 없음 | 본인 계정에 그 그룹 권한이 있는지 → H18 |
| 큰 화면인데 글씨가 작음 | 분할 칸 수를 줄이세요. 칸이 커질수록 글자도 커집니다 |
| 트랜잭션 볼이 안 보임 | 6·8분할에서는 자동으로 꺼집니다. 설정 ▸ 모양에서 상태를 확인하세요 |
관련 문서
- H19. 애플리케이션 그룹으로 대상 묶기 — 그룹 만들기와 표시 이름(별칭)
- H18. 사용자·그룹·권 한 관리 — 볼 수 있는 그룹의 범위
- R4. 공통 UI 요소 — 톱바의 TV 버튼 위치
- T2. 느린 요청 추적하기 — 월보드에서 이상을 본 뒤 콘솔에서 파고들기