본문으로 건너뛰기

대시보드 활용

대시보드는 KIOPS의 "조종석"과 같은 곳입니다. 비행기 조종사가 조종석에서 모든 계기판을 확인하듯이, 여러분은 대시보드에서 모든 서비스의 상태를 한눈에 확인할 수 있습니다.

대시보드는 모니터링 전용 화면입니다

**[대시보드]**는 별도의 탭 구조 없이 단일 서비스 현황 테이블로 구성됩니다. 빌드/배포/재시작 같은 실행 버튼은 대시보드에 없으며, 실행 액션은 서비스 상세 페이지 또는 서비스 관리 페이지에서 수행합니다.

대시보드 접근​

경로: [대시보드] 페이지 (/dashboard)

로그인하면 자동으로 이동하는 첫 화면입니다. 모든 서비스의 현황을 단일 테이블에서 확인할 수 있어요.

화면 구성​

대시보드 페이지는 다음과 같이 구성됩니다.

  • 상단 영역: 검색/필터 입력 영역 (수동 새로고침 버튼은 없으며, 데이터는 WebSocket 실시간 + 자동 로드로 갱신됩니다)
  • 메인 영역: 서비스 현황 테이블 (단일 화면)
  • 상태 인디케이터: WebSocket 연결이 끊겼을 때 상단에 끊김 표시가 노출됨

서비스 현황 테이블​

대시보드의 핵심은 서비스 현황 테이블입니다. 여기서 모든 서비스의 상태를 한눈에 확인하고, 행을 클릭하여 상세 페이지로 진입할 수 있습니다.

컬럼 구성​

테이블에 실제로 노출되는 컬럼은 다음과 같습니다.

  • 즐겨찾기 (별 아이콘): 자주 보는 서비스를 별표로 등록합니다. 등록한 상태는 브라우저 localStorage에 저장되어 같은 브라우저에서 유지되며, 즐겨찾기 항목이 상단으로 정렬됩니다.
  • 서비스 상태: 파이프라인 단계별 상태(Running, Building, Deploying, Build Failed, Deploy Failed, Stopped, Registered 등)를 배지로 표시합니다.
  • 위험도 (riskLevel): 보안 취약점 수 기준으로 자동 계산되는 라벨입니다. (계산 방식은 아래 별도 절 참고)
  • 서비스명: 등록된 서비스 이름입니다.
  • 브랜치: 현재 모니터링 중인 브랜치를 보여주는 드롭다운입니다. 다른 브랜치로 즉시 전환할 수 있습니다.
  • 런타임 환경: 서비스가 배포된 런타임(K8s 클러스터, Docker, Podman 등) 이름입니다.
  • VPN: 해당 서비스 접근 시 사용되는 VPN 프로파일 정보입니다.
  • 이동 (화살표 아이콘): 클릭 시 해당 서비스의 상세 페이지(ServiceDetailView)로 전환됩니다.
빌드/배포/재시작 "작업" 컬럼은 없습니다

대시보드 테이블에는 실행용 액션 버튼 컬럼이 없습니다. 빌드, 배포, 재시작 같은 액션은 서비스 상세 페이지 또는 [서비스 관리] 페이지에서 수행합니다.

위험도(riskLevel) 계산 방식​

위험도 라벨은 서비스의 보안 취약점 통계로부터 자동 산출되며, 4단계(critical/high/medium/low)로 분류됩니다.

  • critical: Critical 취약점이 1개 이상 존재하는 경우
  • high: Critical은 없지만 High 취약점이 1개 이상 존재하는 경우
  • medium: Critical/High는 없지만 Medium 취약점이 1개 이상 존재하는 경우
  • low: Medium/High/Critical 취약점이 모두 0인 경우 (Low 취약점 유무와 무관)

라벨은 4단계 기준으로 색상이 부여되어 한눈에 식별 가능합니다.

서비스 상태 이해하기​

각 서비스는 현재 파이프라인 상태에 따라 다른 색상으로 표시됩니다.

  • Running: 서비스가 정상 실행 중입니다.
  • Building: 빌드 진행 중입니다. 완료까지 기다려 주세요.
  • Deploying: 배포 진행 중입니다.
  • Build Failed: 빌드가 실패했습니다. 상세 페이지에서 로그를 확인하세요.
  • Deploy Failed: 배포가 실패했습니다.
  • Stopped: 서비스가 중지되었습니다.
  • Registered: 등록만 된 상태입니다. 빌드/배포가 아직 수행되지 않았습니다.

필터링 및 검색​

서비스가 많아지면 원하는 서비스를 찾기 어려울 수 있습니다. 상단 입력 영역의 검색/필터를 활용하세요.

  • 상태/위험도 필터: 특정 상태(예: Failed) 또는 특정 위험도(예: critical/high)인 서비스만 표시합니다.
  • 검색: 서비스명으로 부분 일치 검색이 가능합니다.
아침 점검 팁

출근 직후에는 위험도 critical/high 또는 상태 Failed 필터를 먼저 적용해 보세요. 즉시 조치가 필요한 서비스만 추려서 빠르게 확인할 수 있습니다.

WebSocket 실시간 상태 갱신​

대시보드 테이블은 WebSocket 기반으로 파이프라인 상태 변화를 실시간 반영합니다.

  • 빌드/배포 진행/완료/실패 상태가 새로고침 없이 즉시 갱신됩니다.
  • WebSocket 연결이 끊긴 경우 상단에 연결 끊김 인디케이터가 표시됩니다. 이 경우 일시적으로 상태가 지연 갱신될 수 있으므로, 인디케이터가 사라질 때까지 잠시 기다리거나 페이지를 새로고침하세요.

서비스 상세 페이지 (ServiceDetailView)​

테이블에서 서비스를 클릭하거나 우측 이동 아이콘을 누르면 ServiceDetailView로 전환됩니다. 페이지 라우팅이 아니라 동일 대시보드 화면 내 SPA 흐름이며, 좌측 상단의 뒤로가기 버튼으로 테이블 화면으로 복귀할 수 있습니다.

상세 페이지는 별도 탭 없이 개요 단일 화면으로 구성됩니다.

개요 화면​

서비스의 현재 상태와 최근 활동을 보여줍니다.

  • 서비스 기본 정보 (이름, 런타임 환경, VPN, 브랜치 등)
  • 최근 빌드/배포 이력 요약
  • 현재 운영 상태 (Running/Stopped 등)

품질 지표는 [보안 분석]의 [품질] 탭으로 이관됐습니다​

DORA 메트릭, 인시던트(장애 이력), 보안 취약점 요약 등 품질 지표는 더 이상 대시보드 서비스 상세에 표시되지 않습니다. [보안 분석] 페이지의 [품질] 탭(/security?area=quality)에서 확인합니다. (참고: 시스템 전체 수준이 아닌 서비스별 지표입니다.)

  • DORA 메트릭: 배포 빈도, 리드 타임, 변경 실패율, 복구 시간. 자세한 내용은 DORA 메트릭 가이드를 참고하세요.
  • 인시던트 이력: 빌드/배포 실패 시 자동 생성되는 인시던트 목록 및 상태(Open/Resolved). 빌드/배포 실패가 발생하면 KIOPS가 자동으로 인시던트를 기록하므로, 별도의 등록 작업 없이도 실패 이력을 추적할 수 있습니다.
  • 보안 취약점 요약: SAST/SCA/DAST 스캔 결과 기반 취약점 통계.
인시던트 처리 흐름
  1. **[보안 분석]**의 [품질] 탭에서 Open 상태인 인시던트를 확인합니다.
  2. 인시던트 상세에서 에러 로그/관련 빌드 또는 배포 정보를 확인합니다.
  3. 원인을 해결한 후(코드 수정, 설정 변경 등) 인시던트를 Resolved로 변경합니다.

실제 사용 시나리오​

실제로 대시보드를 어떻게 활용하는지 시나리오별로 알아보겠습니다.

시나리오 1: 아침 상태 점검​

매일 아침 출근하면 가장 먼저 해야 할 일입니다. 밤사이에 문제가 생겼는지 확인합니다.

점검 순서:

  1. [대시보드] 페이지에 접속합니다.
  2. 테이블 상단의 위험도 필터에서 critical/high를 선택하거나, 상태 필터에서 Failed를 선택합니다.
  3. 추려진 행이 있다면 해당 서비스 행의 이동 아이콘을 클릭하여 상세 페이지로 진입합니다.
  4. 개요 화면에서 최근 빌드/배포 결과를 확인하고, 필요한 경우 **[보안 분석]**의 [품질] 탭에서 인시던트 상세를 확인합니다.
  5. 원인을 해결한 후 [서비스 관리] 페이지에서 재빌드 또는 재배포를 실행합니다.

시나리오 2: 즐겨찾기로 핵심 서비스 모니터링​

여러 서비스를 운영 중이라면 즐겨찾기를 활용해 핵심 서비스만 빠르게 추적할 수 있습니다.

  1. 핵심 서비스 행 좌측의 별 아이콘을 클릭하여 즐겨찾기를 등록합니다.
  2. 즐겨찾기한 서비스는 테이블 상단으로 정렬됩니다.
  3. 즐겨찾기 상태는 브라우저 localStorage에 저장되어, 같은 브라우저에서는 새로고침 후에도 유지됩니다.

시나리오 3: 보안 위험도 리뷰​

위험도 라벨로 보안 취약점 분포를 한눈에 파악할 수 있습니다.

  1. 위험도 필터에서 critical을 선택해 즉시 조치가 필요한 서비스를 추립니다.
  2. **[보안 분석]**의 [품질] 탭에서 해당 서비스의 보안 취약점 요약을 확인합니다.
  3. 우선순위가 높은 취약점부터 처리하고, 수정 후 보안 분석을 재실행하여 해결 여부를 확인합니다.

베스트 프랙티스​

효과적인 서비스 관리를 위한 권장 루틴을 소개합니다.

일일 루틴​

하루 세 번 점검

아침, 점심, 퇴근 전. 이 세 번의 점검만으로도 대부분의 문제를 빠르게 발견할 수 있습니다.

  • 아침: 전체 서비스 상태와 위험도 라벨을 훑어봅니다. 밤사이 발생한 문제를 빨리 발견할 수 있습니다.
  • 점심: 알림 드로어를 열어 새로 도착한 파이프라인 알림을 확인합니다.
  • 퇴근 전: Failed 상태와 Open 상태 인시던트를 점검합니다.

주간 루틴​

팀 차원의 개선을 위한 주간 점검입니다.

  • 월요일: 핵심 서비스의 [보안 분석] [품질] 탭에서 DORA 메트릭을 리뷰하여 지난 주 DevOps 성과를 분석합니다.
  • 금요일: 한 주간 발생한 인시던트를 회고하고, 재발 방지 대책을 논의합니다.
좋은 습관이 좋은 결과를 만듭니다

처음에는 번거롭게 느껴질 수 있지만, 이런 루틴이 몸에 익으면 문제를 조기에 발견하고 빠르게 대응할 수 있게 됩니다.

관련 가이드​