본문으로 건너뛰기

4.3. 배포

애플리케이션의 배포(Deployment) 이력과 각 배포가 서비스에 미친 영향을 테이블 형태로 확인합니다.

배포 화면

개요​

배포 메뉴에서는 Kubernetes 클러스터에 배포된 애플리케이션의 전체 배포 이력을 확인할 수 있습니다. OPENMARU Observability는 CI/CD 도구와의 별도 연동 없이 Kubernetes 메타데이터를 활용하여 애플리케이션의 롤아웃(Rollout)을 자동으로 감지합니다.

각 배포의 버전, 시간, 경과 시간 등 기본 정보와 함께, 배포 후 서비스 상태 변화를 요약 정보로 제공합니다. 새로운 버전이 배포된 직후 가용성이나 응답 시간에 문제가 발생했는지, CPU/메모리 사용량에 변화가 있는지, 컨테이너 재시작이나 로그 오류가 증가했는지 등을 한눈에 파악할 수 있어 배포의 안정성을 빠르게 검증할 수 있습니다.

좌측 사이드바에서 배포 메뉴를 클릭하면 이 화면으로 이동합니다.

화면 구성​

배포 페이지는 다음 영역으로 구성됩니다.

영역설명
상단 헤더페이지 제목 및 애플리케이션 필터(검색, 네임스페이스, 카테고리)
배포 이력 테이블전체 배포 목록 및 각 배포의 상태/요약 정보
페이지네이션페이지당 표시 항목 수 변경 및 페이지 이동

배포 이력 테이블 읽는 법​

배포 이력 테이블

배포 이력 테이블에는 감지된 모든 배포가 시간순으로 나열됩니다. 각 행이 하나의 배포를 나타내며, 다음 컬럼으로 구성됩니다.

컬럼설명
애플리케이션배포된 애플리케이션 이름. 배포 상태에 따라 아이콘 색상이 달라집니다. 클릭하면 해당 애플리케이션 상세 페이지로 이동합니다.
네임스페이스애플리케이션이 속한 네임스페이스(Namespace)
종류(Kind)Kubernetes 워크로드 종류 (예: Deployment, StatefulSet). Kubernetes 리소스는 파란색 배지, 외부 서비스(ExternalService)는 녹색 배지로 구분됩니다.
배포명칭배포 버전(이미지 태그 등)과 현재 배포의 수명(경과 시간). 버전 좌측의 원형 표시등으로 배포 상태를 나타냅니다. 클릭하면 해당 애플리케이션 상세 페이지로 이동합니다.
배포시간배포가 실행된 날짜와 시각(예: 2026-03-15 14:30:00), 그리고 현재 시점 기준 경과 시간(예: 2.1 일 전)
요약배포 후 서비스 상태 변화에 대한 자동 분석 결과

테이블 정렬​

컬럼 헤더를 클릭하면 해당 컬럼 기준으로 오름차순/내림차순 정렬이 가능합니다. 여러 컬럼을 순차적으로 클릭하면 다중 정렬도 지원됩니다.

팁: 배포시간 컬럼을 클릭하여 최신 배포 순으로 정렬하면 가장 최근 배포를 빠르게 확인할 수 있습니다.

데이터가 없는 경우​

클러스터에서 배포가 감지되지 않은 경우 테이블에 "배포 감지 안됨" 메시지가 표시됩니다. 클러스터 에이전트가 정상적으로 설치되어 있는지 확인하세요.

배포 상태 확인​

배포 상세 정보

각 배포의 상태는 애플리케이션 컬럼의 아이콘 색상과 배포명칭 컬럼의 원형 표시등으로 확인할 수 있습니다.

상태색상의미
정상녹색배포가 정상적으로 완료되어 서비스에 문제가 없는 상태
경고노란색배포 후 주의가 필요한 변화가 감지된 상태
심각빨간색 (깜빡임)배포 후 심각한 문제가 감지되어 즉각 조치가 필요한 상태

상태 아이콘의 의미​

  • 애플리케이션 컬럼: 정상 배포에는 로켓 아이콘이 녹색으로, 경고 또는 심각 상태에서는 알림 아이콘이 노란색 또는 빨간색으로 표시됩니다. 심각 상태에서는 아이콘이 깜빡이므로 시각적으로 빠르게 인지할 수 있습니다.
  • 배포명칭 컬럼: 버전명 좌측에 작은 원형 표시등이 배포 상태 색상(녹색/노란색/빨간색)으로 표시됩니다.

참고: 두 위치의 상태 색상은 동일한 배포 분석 결과를 반영합니다. 테이블을 빠르게 스캔할 때 녹색 이외의 색상이 보이면 해당 배포를 우선적으로 확인하세요.

배포 전후 비교 — 요약 정보​

요약 컬럼에는 배포 후 서비스 상태 변화가 자동으로 분석되어 표시됩니다. OPENMARU Observability는 새 버전이 배포된 후 약 30분간 데이터를 수집하여 이전 배포와 비교 분석합니다. 분석 항목은 SLO(Service Level Objective, 서비스 수준 목표), 로그 오류, 컨테이너 재시작, CPU 사용량, 메모리 사용량 등입니다.

배포 결과​

요약 메시지의미
서비스가 성공적으로 배포되었습니다배포가 정상 완료되고 서비스에 문제가 없음
배포가 취소되었습니다배포 프로세스가 중단됨
롤아웃(Rollout)이 진행중입니다새 버전의 Pod이 기존 버전을 점진적으로 대체하는 과정 중
배포에 중요한 변경 사항이 없습니다이전 배포와 비교하여 유의미한 변화가 감지되지 않음

참고: 롤아웃(Rollout)은 새 버전의 Pod이 기존 버전을 점진적으로 대체하는 Kubernetes 배포 프로세스입니다. 롤아웃이 오래 지속되는 경우 컨테이너 이미지 문제 또는 Pod 스케줄링 문제를 점검해야 합니다.

SLO 관련​

요약 메시지의미
가용성: (실제값) (목표: (목표값))배포 후 가용성 SLO 준수율과 목표값 비교
응답 시간: (실제값) 초당 (값)ms (목표: (목표값))배포 후 응답 시간 SLO 준수율과 목표값 비교

SLO 항목에 경고 아이콘이 표시되면 배포 후 SLO를 위반하고 있다는 의미입니다. 정상인 경우 체크 아이콘이 표시됩니다.

리소스 변화​

요약 메시지의미
CPU 사용량: 이전 배포에 비해 N% 달라짐이전 배포 대비 CPU 사용량 변화율
메모리 사용량: 이전 배포에 비해 N% 달라짐이전 배포 대비 메모리 사용량 변화율
메모리 누수가 해결되었습니다이전 배포에서 감지된 메모리 누수가 해소됨
메모리: 메모리 증가가 감지됨시간당 메모리 사용량이 지속 증가하여 메모리 누수가 의심되는 상태
메모리: 컨테이너가 메모리 부족으로 인해 OOM Killer가 N번 재시작 시켰습니다OOM(Out of Memory)으로 컨테이너가 강제 재시작됨

안정성 관련​

요약 메시지의미
Crash: 컨테이너가 N번 재시작 되었습니다배포 후 컨테이너가 비정상 종료되어 재시작됨
로그: 로그에 오류가 있습니다배포 후 애플리케이션 로그에서 오류가 감지됨
로그: 더이상 로그에 오류가 없습니다이전 배포에 있던 로그 오류가 해소됨
로그: 로그에 오류가 N번으로 N% 달라졌습니다이전 배포 대비 로그 오류 발생 건수와 변화율

요약 정보 상세 확인​

요약 메시지 항목에 돋보기 아이콘이 표시된 경우, 마우스를 올리면 아이콘이 나타나며 클릭하면 해당 애플리케이션의 상세 페이지로 이동합니다. 상세 페이지에서는 배포 전후의 메트릭(Metric)을 차트로 비교 분석할 수 있습니다.

참고: 요약 정보는 배포 후 데이터를 추가 분석하여 표시되므로, 배포 직후에는 로딩 표시가 나타날 수 있습니다. 배포 시작 후 30분 이내에는 충분한 데이터가 수집되지 않아 "시작한지 30분 이내이기 때문에 데이터가 부족합니다" 메시지가 표시될 수 있습니다.

애플리케이션 필터​

페이지 우측 상단의 애플리케이션 필터를 사용해 배포 이력을 좁힐 수 있습니다. 다음 조건을 조합하여 원하는 배포만 표시할 수 있습니다.

필터 항목설명
검색애플리케이션 이름을 직접 입력하여 빠르게 검색
네임스페이스특정 네임스페이스(Namespace)의 애플리케이션만 표시. 여러 네임스페이스를 동시에 선택 가능
카테고리애플리케이션 카테고리별 필터링

팁: 네임스페이스와 카테고리를 조합하면 특정 팀이 관리하는 애플리케이션의 배포 이력만 집중적으로 확인할 수 있습니다.

페이지네이션​

배포 이력이 많은 경우 테이블 하단의 페이지네이션을 통해 페이지당 표시 항목 수를 10, 20, 50, 100개 또는 **전체(All)**로 변경할 수 있습니다. 기본값은 20개입니다.

애플리케이션 상세 페이지로 이동​

배포 목록에서 애플리케이션 이름 또는 **배포명칭(버전)**을 클릭하면 해당 애플리케이션의 상세 페이지로 이동합니다. 상세 페이지에서는 다음 정보를 확인할 수 있습니다.

  • SLO 현황: 가용성 및 응답 시간 목표 대비 실제 준수율
  • CPU/메모리 추세: 배포 전후 리소스 사용량 변화 차트
  • 로그: 배포 후 오류 로그 패턴 확인
  • 분산추적: 배포 후 응답 시간 분포 변화 확인
  • 인스턴스 상태: Pod 재시작, OOM 이벤트 등 확인

팁: 배포 후 문제가 의심되면 상세 페이지의 각 리포트 탭 좌측에 표시되는 상태 표시등(녹색/노란색/빨간색)을 확인하세요. 문제가 있는 영역을 빠르게 파악할 수 있습니다.

활용 시나리오​

새 버전 배포 후 안정성 검증​

  1. 사이드바에서 배포 메뉴를 클릭합니다.
  2. 배포시간 컬럼을 클릭하여 최신 배포 순으로 정렬합니다.
  3. 방금 배포한 애플리케이션의 행을 찾아 요약 컬럼을 확인합니다.
  4. 요약에 "서비스가 성공적으로 배포되었습니다"가 표시되면 배포가 안정적으로 완료된 것입니다.
  5. 경고 메시지가 있으면 해당 항목의 돋보기 아이콘을 클릭하여 상세 메트릭을 분석합니다.

배포로 인한 성능 저하 추적​

  1. 배포 메뉴에서 애플리케이션 필터로 대상 애플리케이션을 선택합니다.
  2. 각 배포의 요약 컬럼에서 CPU/메모리 변화율, SLO 준수율을 비교합니다.
  3. 성능이 저하된 배포 행의 애플리케이션 이름을 클릭하여 상세 페이지로 이동합니다.
  4. 상세 페이지에서 CPU, 메모리, 응답 시간 차트를 통해 이전 배포 대비 변화를 분석합니다.

배포 실패 또는 롤아웃 정체 확인​

  1. 배포 메뉴에서 상태가 빨간색(심각) 또는 노란색(경고)인 행을 확인합니다.
  2. 요약 컬럼에 "배포가 취소되었습니다" 또는 "롤아웃이 진행중입니다" 메시지가 있는지 확인합니다.
  3. 롤아웃이 장시간 진행 중인 경우, 컨테이너 이미지 또는 리소스 할당 문제를 점검합니다.

관련 문서​