대시보드 개요 가이드

GIIP 플랫폼 로그인 후 나타나는 전체 인프라 현황 대시보드를 활용하는 방법을 안내합니다.

🚀 대시보드 페이지로 이동 →

📋 개요

대시보드는 전 세계에 분산된 귀하의 인프라 상태를 한눈에 파악할 수 있는 통합 관제 화면입니다. 실시간 메트릭과 비용 데이터를 시각화하여 신속한 의사결정을 돕습니다.

🧭 화면 구조 — 3층 배치 (giip #2443/#2444/#2445/#2446)

대시보드 상단은 "내가 지금 결정해야 할 것"과 "전 프로젝트가 어떻게 돌아가는지" 두 가지만 먼저 보여주고, 나머지 상세는 아래로 내립니다. 프로젝트가 많아도 모바일 한 화면에 들어오게 하는 것이 목적입니다.

① 내가 결정할 것

사람이 판단해야만 움직이는 이슈만 최대 5줄로 보여줍니다.

• 대상: 상태가 NEEDS_DECISION 또는 WARN 인 이슈뿐입니다.
• REVIEW 정체 / 게이트 되돌림 / 60분 무활동 같은 것은 봇이 매시 자동으로 재판정하므로 여기에 올라오지 않습니다(③층 소관).
• 확인할 것이 없으면 빈 카드 대신 "확인할 것 없음" 한 줄만 나옵니다.
• 5건을 넘으면 상위 5건 + "+N건 더" 링크가 나오고, 링크는 이슈 목록(NEEDS_DECISION 필터)으로 이동합니다.
• 각 줄을 누르면 그 이슈 상세로 이동합니다.
• 이 층의 건수 자체가 자동화 품질 지표입니다. 자동화가 제대로 돌면 숫자가 줄어듭니다.

② 프로젝트 현황

접근 권한이 있는 프로젝트를 하나에 한 줄씩 보여줍니다.

항목	의미
진행	IN_PROGRESS 이슈 수
대기	READY + PENDING 이슈 수
막힘	NEEDS_DECISION + WARN + 60분 이상 코멘트 없는 IN_PROGRESS + 게이트 3회 에스컬레이션

• 신호등: 막힘 1건 이상이면 🔴, 막힘 0이고 진행+대기가 1건 이상이면 🟢, 전부 0이면 ⚪(숫자 대신 "—" 표시).
• ⚠️ ②층의 막힘은 ①층보다 넓은 개념입니다. ①층은 "사람이 결정할 것", ②층 막힘은 "프로젝트 건강도"입니다.
• 한 이슈가 여러 조건에 걸려도 한 번만 셉니다(중복 집계 없음).
• 진행 중이면서 60분 이상 멈춘 이슈는 진행과 막힘 양쪽에 잡힙니다 — "진행 중이긴 한데 멈춰 있다"를 한 줄에서 보기 위한 의도된 동작입니다.
• 줄을 누르면 그 프로젝트가 선택되고, 다시 누르면 해제됩니다. 이 선택은 이 대시보드 화면 안에서만 적용됩니다(③층이 그 프로젝트만 보여줍니다).
• 줄 오른쪽의 "들어가기 →" 버튼은 다릅니다. 누르면 상단 프로젝트 선택과 똑같이 로그인 세션의 프로젝트가 바뀌고, 페이지가 새로고침되어 앱 전체(서버 목록·이슈·KVS 등)가 그 프로젝트 기준으로 바뀝니다.
  • 화면이 좁으면 글자는 숨고 → 화살표만 보입니다. 기능은 같습니다.
  • 이미 들어가 있는 프로젝트에서는 이 버튼이 회색 ✓ 로 바뀌고 눌리지 않습니다 — 눌러봐야 새로고침만 되기 때문입니다.
  • 즉 줄을 누르는 것 = 이 화면에서만 좁혀 보기, "들어가기" = 그 프로젝트로 실제로 이동입니다.
• 완료(DONE) 이슈는 어떤 숫자에도 포함되지 않습니다.

③ 막힌 이슈

"이슈가 어딘가에 멈춰 있다"는 모든 경우를 한 섹션에 모아 보여줍니다. 기본은 접혀 있고(모바일은 항상 접힘), 제목 옆 건수 배지로 몇 건인지 접은 채로 알 수 있습니다.

• 같은 이슈는 한 줄로만 나옵니다. 예전에는 위젯이 5개로 나뉘어 있어 같은 이슈가 여러 번 나왔습니다(실측: 이슈 #2148 이 3개 위젯에 동시 노출).
• 대신 걸린 사유를 배지로 병기합니다. 사유가 2개면 배지가 2개 붙습니다.

배지	의미
완료위조 의심	상태가 WARN — 완료 판정이 반복 번복된 이슈
사용자 결정 대기	상태가 NEEDS_DECISION
게이트 3회	자동 되돌림이 3회 상한에 도달해 사람 확인이 필요해진 이슈
게이트 되돌림	되돌림이 1회 이상 있었으나 아직 3회 상한 전
REVIEW 정체 / PENDING 정체	그 상태로 7일 이상 활동 없음 (괄호 안은 경과 일수)
PR 없음	REVIEW 인데 대응 PR 이 어느 저장소에도 없음
무활동	IN_PROGRESS 인데 60분 이상 코멘트 없음 (괄호 안은 경과 분)

• 배지 색은 3단계입니다 — 빨강은 사람이 손대야 끝나는 것, 노랑은 자동화가 재시도 중이거나 정체된 것, 회색은 보조 정보입니다.
• ②층에서 프로젝트를 선택하면 이 목록이 그 프로젝트만 보여줍니다. 같은 줄을 다시 누르면 전체로 돌아옵니다.
• 완료(DONE) 이슈는 나오지 않습니다.
• 20건까지 먼저 보이고 "+N건 더 보기"로 나머지가 펼쳐집니다(데이터를 버리는 것이 아니라 화면만 접습니다).

③ 상세 — 나머지 섹션

막힌 이슈 아래로 에러·인프라·참고 통계 섹션이 전부 접이식으로 이어집니다. 모두 같은 규칙(건수 배지 · 0건은 회색 + 최하단 · 상태 기억)을 따릅니다.

섹션	헤더 배지의 숫자	기본 상태	내용
막힌 이슈	막혀 있는 이슈 수	데스크톱만 펼침	위의 ③ 참조
SES 제안서	조치 필요(pending+failed+analyzing) 건수	uLevel≥70만 표시	csn=0 공개 제안서의 상태별 요약 + 상위 3건 액션 링크
열린 이슈	완료되지 않은 이슈 전체 수	항상 접힘	진행/대기 중인 이슈 목록(25·50·100건 단위)
에러 로그	미해결 에러 수	접힘	총계/해결/미해결/최근 타일 + 출처별·심각도별 분포
할 일 제안	제안 건수	접힘	오래 점검되지 않은 서버를 한 건씩 확인·삭제
서버 상태 통계	비정상 서버 수	접힘	프로젝트/서버 수 + 정상·비정상 도넛 + 비정상 서버 목록
도메인 만료일	30일 내 만료 도메인 수	접힘	만료가 임박한 순서로 정렬(이미 만료된 건수는 별도 배지)
프로젝트 & 서버	프로젝트 수	접힘	프로젝트별 서버 수/정상/비정상(비정상 많은 순)
KVS 활동 요약	활동이 있었던 Factor 종류 수	접힘	최근 24시간 수집 현황

• 열린 이슈가 기본으로 접혀 있는 이유: 대시보드에서 가장 긴 목록이라 펼쳐 두면 그 아래 섹션이 전부 스크롤 밖으로 밀립니다. 접혀 있어도 제목 옆 숫자가 전체 건수를 알려주므로 "몇 건 있는지"는 펼치지 않고도 알 수 있습니다.
• 헤더 배지는 "지금 화면에 보이는 줄 수"가 아니라 "열어볼 이유가 되는 수" 입니다. 예를 들어 에러 로그는 총 에러가 아니라 미해결 에러 수를, 서버 상태는 총 서버가 아니라 비정상 서버 수를 보여줍니다.
• 조회에 실패하면 배지에 0 대신 … 이 표시됩니다 — 0으로 적으면 "문제가 없다"는 잘못된 신호가 되기 때문입니다.
• 에러 로그 섹션은 uLevel 70 이상인 계정에만 나타납니다.

접기/펼치기

• 각 섹션 제목 옆의 건수 배지는 접어도 계속 보입니다 — 접었다고 해서 모르게 되지 않습니다.
• 0건 섹션은 숨기지 않고 회색으로 낮춘 뒤 목록 맨 아래로 내려갑니다. 볼 것이 있는 섹션이 항상 위에 모입니다.
• 처음 열었을 때: 모바일(화면 폭 768px 미만)에서는 ③층이 전부 접혀 ①②층이 첫 화면에 들어옵니다. 데스크톱에서는 ③층의 첫 섹션("막힌 이슈")만 펼쳐집니다.
• 접고 편 상태는 브라우저별로 기억되며, 한 번이라도 직접 접거나 펴면 그 선택이 위의 기본값보다 우선합니다.
• 프라이빗 창처럼 저장이 막힌 환경에서도 화면은 정상 동작하며, 상태만 기억되지 않습니다.
• 접힌 내용은 화면에서 빼두었다가 펼칠 때 불러옵니다(모바일 초기 로딩 절약).

🔍 주요 위젯 설명

1. 실시간 자산 상태 (Asset Status)

현재 관리 중인 서버와 데이터베이스의 총 개수 및 상태(Running, Stopped, Warning)를 카드 형식으로 보여줍니다. 클릭 시 해당 목록 페이지로 이동합니다.

2. 글로벌 인프라 맵 (Infrastructure Map)

서버가 위치한 물리적 지역을 지도 위에 표시합니다. 특정 지역의 클러스터에 장애가 발생하면 지도의 아이콘이 붉은색으로 점멸합니다.

3. 멀티 클라우드 비용 요약

Azure, AWS 등 연결된 클라우드 계정의 이번 달 누적 예상 비용을 비중별(Pie Chart)로 표시합니다. 전월 대비 증감 추이를 확인할 수 있습니다.

4. 최근 이슈 및 알람

가장 최근에 발생한 크리티컬(Critical) 및 워닝(Warning) 이슈들을 리스트업합니다. 이슈를 클릭하여 상세 원인 분석 페이지로 즉시 이동할 수 있습니다.

🛠️ 활용 팁

• 필터링: 대시보드 상단의 [프로젝트 선택] 필터를 통해 특정 프로젝트의 데이터만 집중적으로 모니터링할 수 있습니다.
• 새로고침: 대시보드 데이터는 1분 주기로 자동 갱신됩니다. 수동 갱신이 필요하면 우측 상단의 [새로고침] 아이콘을 클릭하세요.

💡 유의 사항

• 특정 지표가 Unknown으로 표시된다면 해당 서버의 [에이전트 상태]를 먼저 확인하시기 바랍니다.

API 참조

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 API 레퍼런스 개요 (v1.2)

문제 해결

증상	원인	해결
지표가 Unknown으로 표시됨	해당 서버의 에이전트가 응답하지 않음	서버의 [에이전트 상태]를 확인하고 에이전트를 재시작합니다.
대시보드 데이터가 갱신되지 않음	자동 갱신(1분 주기)이 지연되거나 세션이 만료됨	우측 상단 [새로고침] 아이콘을 클릭하거나 다시 로그인합니다.
비용 요약이 비어 있음	클라우드 계정(Azure, AWS)이 연결되지 않음	클라우드 계정 연동 설정을 확인합니다.
특정 프로젝트 데이터만 표시됨	상단 [프로젝트 선택] 필터가 적용되어 있음	필터를 전체로 변경하여 모든 데이터를 표시합니다.

---

버전: 1.2 최종 업데이트: 2026-09-15 소스 파일: giipv3/public/help/dashboard.ko.md