알림 관리
빌드가 완료되었는지, 배포가 성공했는지 매번 직접 확인하러 가기는 번거롭습니다. KIOPS의 알림 시스템을 활용하면 중요한 이벤트가 발생했을 때 바로 알 수 있습니다.
KIOPS 알림은 헤더 우측 종 아이콘을 통해 열리는 In-App 알림 드로어 형태로만 제공됩니다. Slack, 이메일, 브라우저 푸시 같은 외부 채널 발송은 코드 기준 확인되지 않으므로, 본 가이드는 In-App 알림 흐름을 중심으로 설명합니다.
알림 시스템 개요
KIOPS는 화면 우측 상단의 종 모양 아이콘을 통해 알림을 제공합니다.
- 알림 아이콘: 헤더 우측에 위치한 종 모양 아이콘을 클릭하면 알림 드로어가 열립니다.
- 읽지 않은 알림 배지: 확인하지 않은 알림이 있으면 아이콘 위에 빨간색 숫자 배지가 표시됩니다.
- 알림 드로어: 아이콘을 클릭하면 화면 우측에서 최근 알림 목록이 슬라이드되어 나타납니다.
알림 유형 (type)
KIOPS 알림은 코드 기준으로 다음 type을 사용합니다(타입 정의상 organization_invite/membership_request/system/pipeline/other 5종이 선언되어 있으며, pipeline 은 타입에만 존재하고 실제 파이프라인 알림은 system type + data.stage 로 표현됩니다).
organization_invite (기관 초대)
기관 관리자가 사용자를 초대했을 때, 초대받은 사용자에게 도착하는 알림입니다.
pending상태에서 수락 / 거절 버튼이 노출됩니다.- 응답하면 status가
accepted또는rejected로 변경됩니다.
membership_request (가입 신청)
사용자가 기관 가입을 신청했을 때, 해당 기관 관리자에게 도착하는 알림입니다.
- 새로운 가입 신청이 도착한 경우 (
pending상태에서 승인 / 거절 버튼 노출) - 처리가 완료된 알림은 읽음 처리만 가능합니다.
system (시스템)
KIOPS의 파이프라인 단계별 알림이 이 type으로 발송됩니다. 파이프라인 7단계(stage) 각각에 대해 시작/완료/실패 상태가 별도 알림으로 도착합니다. 액션은 읽음 버튼만 노출됩니다.
other (기타)
위 세 type에 해당하지 않는 알림입니다. 운영상 특수 알림이 이 type으로 분류될 수 있으며, 액션은 읽음 버튼만 노출됩니다.
- Critical/High 취약점 알림, 보안 스캔 완료 알림
- 인시던트 발생/해결 알림 (인시던트는 서비스 상세 → 품질 관리 탭에서 확인)
- 시스템 점검 알림
- 롤백 완료 알림
파이프라인 알림 (system type)
system type 알림은 파이프라인 단계별로 발송됩니다. KIOPS 파이프라인은 다음 7개 stage로 구성됩니다.
| stage | 설명 |
|---|---|
| source | 소스 코드 가져오기 단계 |
| sast | 정적 분석(SAST) 단계 |
| build | Docker 이미지 빌드 단계 |
| sca | 의존성 분석(SCA) 단계 |
| deploy | 배포 단계 |
| operation | 운영 단계 |
| dast | 동적 분석(DAST) 단계 |
stage × stageStatus 매트릭스
각 stage는 다음 3가지 stageStatus를 가질 수 있으며, 그에 따라 별도 알림이 도착합니다.
| stage | started (시작) | completed (완료) | failed (실패) |
|---|---|---|---|
| source | 소스 가져오기 시작 | 소스 가져오기 완료 | 소스 가져오기 실패 |
| sast | SAST 분석 시작 | SAST 분석 완료 | SAST 분석 실패 |
| build | 빌드 시작 | 빌드 완료 | 빌드 실패 |
| sca | SCA 분석 시작 | SCA 분석 완료 | SCA 분석 실패 |
| deploy | 배포 시작 | 배포 완료 | 배포 실패 |
| operation | 운영 작업 시작 | 운영 작업 완료 | 운영 작업 실패 |
| dast | DAST 스캔 시작 | DAST 스캔 완료 | DAST 스캔 실패 |
실패(failed) 알림에는 errorMessage 필드가 포함되며, 알림 드로어에서 상세 보기 토글로 펼쳐 원인 메시지를 확인할 수 있습니다.
알림 status (4종)
각 알림은 처리 상태(status)에 따라 다음 4가지 값을 가집니다.
- pending: 아직 처리되지 않은 상태(조직 초대/요청 알림에서 응답 대기)
- accepted: 조직 초대를 수락하거나 요청을 승인한 상태
- rejected: 조직 초대를 거절하거나 요청을 거절한 상태
- read: 일반 알림을 읽음 처리한 상태
알림 확인하기
알림을 확인하고 대응하는 방법을 단계별로 알아보겠습니다.
Step 1: 알림 드로어 열기
- 화면 우측 상단의 종 아이콘을 찾습니다.
- 읽지 않은 알림이 있으면 빨간색 배지로 개수가 표시됩니다.
- 아이콘을 클릭하면 알림 드로어가 우측에서 슬라이드되어 열립니다.
Step 2: 알림 목록 확인
알림 목록에서 확인할 수 있는 정보입니다.
- 제목/내용: 어떤 이벤트인지와 상세 설명
- 시간: 알림이 발생한 시간(예: "5분 전")
- 관련 서비스: 파이프라인 알림의 경우 서비스명 표시
- errorMessage 상세 보기 토글: 실패 알림에서 펼쳐서 원인 확인
Step 3: 알림에 대응하기
알림 type과 처리 상태(status)에 따라 노출되는 액션 버튼이 다릅니다.
- organization_invite (pending): 초대받은 사용자에게 도착한 기관 초대로, 수락 / 거절 버튼이 노출됩니다. 응답하면 status가 accepted 또는 rejected로 변경됩니다.
- membership_request (pending): 관리자에게 도착한 가입 신청으로, 승인 / 거절 버튼이 노출됩니다. 응답하면 status가 accepted 또는 rejected로 변경됩니다.
- system / other / 이미 처리된 알림: 읽음 텍스트 버튼만 노출됩니다. 클릭하면 status가 read로 변경됩니다.
- 모두 읽음: 드로어 상단의 "모두 읽음" 버튼을 누르면 일반 알림이 일괄적으로 read 처리됩니다.
type × 액션 매핑
| type | 노출 액션 |
|---|---|
| organization_invite | 수락 / 거절 |
| membership_request | 승인 / 거절 |
| system / other | 읽음 |
알림 행 자체를 클릭해도 관련 상세 페이지로 이동하지 않습니다. 액션 버튼(읽음/수락/거절/승인) 및 실패 알림의 상세 보기 토글만 동작합니다.
알림 정리는 읽음 처리 또는 모두 읽음 액션으로만 수행할 수 있습니다. 개별 알림을 수동으로 삭제하는 UI는 제공되지 않습니다.
실제 사용 시나리오
시나리오 1: 빌드 실패 대응
코드를 푸시한 후 다른 작업을 하고 있었는데, 알림 아이콘에 빨간색 배지가 나타났습니다.
대응 순서:
- 알림 아이콘을 클릭하여 알림 드로어를 엽니다.
- "빌드 실패: my-service" (stage=build, stageStatus=failed) 알림을 확인합니다.
- 알림 행의 상세 보기 토글로 errorMessage를 펼쳐 원인을 빠르게 파악합니다.
- 알림 행 자체에는 페이지 이동 동작이 없으므로, 좌측 메뉴의 [대시보드] 또는 [서비스 관리]에서 해당 서비스 상세로 직접 이동합니다.
- 빌드 로그에서 추가 정보를 확인한 후 코드를 수정하고 재빌드를 실행합니다.
시나리오 2: 배포 진행 모니터링
배포를 시작했는데, 다른 작업을 하면서도 진행 상황을 알고 싶습니다.
모니터링 순서:
- 배포를 시작하면 stage=deploy, stageStatus=started 알림이 도착합니다.
- 배포가 완료되면 stage=deploy, stageStatus=completed 알림이 도착합니다.
- 실패하면 stage=deploy, stageStatus=failed 알림이 도착하며, errorMessage 상세 보기로 원인을 빠르게 확인할 수 있습니다.
베스트 프랙티스
효율적인 알림 관리
- 실패 알림 우선 확인: stage가 무엇이든 stageStatus=failed 알림은 우선 확인하고 errorMessage를 펼쳐보세요.
- 읽음 처리: 처리가 완료된 일반 알림은 바로 읽음 버튼으로 처리하세요.
- 모두 읽음 활용: 알림이 누적된 경우 상단의 모두 읽음 버튼으로 일괄 정리하세요.
팀 협업
멤버십 요청 알림은 담당 관리자가 빠르게 응답해야 협업 흐름이 끊기지 않습니다. 응답 담당을 명확히 정해두세요.
- 파이프라인 실패 알림이 도착하면 담당자가 errorMessage를 확인하고 채널에 공유합니다.
- 멤버십 요청 알림은 관리자가 승인/거절로 즉시 응답합니다.
문제 해결
알림 배지가 표시되지 않는 경우
가능한 원인: 브라우저 캐시 문제일 수 있습니다.
해결 방법:
- 페이지 새로고침 (F5)
- 강력 새로고침 (Ctrl+Shift+R)
알림 드로어가 열리지 않는 경우
가능한 원인: 일시적인 UI 문제일 수 있습니다.
해결 방법:
- 페이지를 새로고침해 주세요.
- 문제가 지속되면 다른 브라우저에서 시도해 보세요.
- 그래도 안 되면 관리자에게 문의하세요.