알림 종류
누구에게 무엇이 언제 가는지. 화면에 안 뜬 일도 알림으로 남는다.
구조
모든 알림에 세 가지가 붙는다.
| 항목 | 값 |
|---|---|
| 받는 쪽 | team · org_admin · super_admin |
| 분류 | credit · reservation · serverless · system |
| 종류 | 아래 표의 kind |
알림은 대부분 관련 화면으로 가는 링크를 함께 갖는다.
팀 사용자에게
크레딧
| kind | 언제 | 제목 |
|---|---|---|
threshold_warning | 잔여가 임계값(기본 30%·10%) 도달 | 팀 크레딧이 임계값(n%)에 도달했습니다 |
exhaust_imminent | 소진 임박 | 크레딧 소진 임박 — 확보된 잔여분 소진 시 자동 중지됩니다 |
team_locked | 크레딧 소진으로 잠김 | 팀이 잠겼습니다 · 크레딧 소진 |
unlocked | 잠금 해제 | 팀 잠금이 해제되었습니다 |
launch_refused | 크레딧 부족으로 시작 거부 | 크레딧이 부족하여 인스턴스를 시작할 수 없습니다 |
credits_exhausted | 소진으로 자동 중지 | 크레딧 소진으로 인스턴스가 자동 중지되었습니다 |
auto_stop | 타이머 만료로 중지 | 자동 중지 시간이 되어 인스턴스가 중지되었습니다 |
team_locked | 잠금으로 인스턴스 중지 | 팀 잠금으로 인스턴스가 중지되었습니다 |
request_approved | 예산 증액 요청 승인 | 예산 증액 요청이 승인되었습니다 (+n C) |
team_locked 알림은 본문에 이렇게 온다: 모든 인스턴스가 자동 중지되었고, 새 예약·실행· 서버리스 호출이 차단됩니다. 데이터와 볼륨은 유지됩니다.
예약
| kind | 언제 | 제목 |
|---|---|---|
approved | 승인·확정 | 예약이 승인·확정되었습니다 |
adjusted | 조건 조정 회신 | 운영팀이 예약 조건을 조정해 회신했습니다 |
rejected | 반려 | 예약 신청이 반려되었습니다 |
rejected | 크레딧 부족 자동 반려 | 예약이 자동 반려되었습니다 |
rejected | 조정안 무응답 만료 | 조정안 무응답으로 예약이 자동 반려되었습니다 |
cancelled | 조정안 거절 | 조정안을 거절해 예약이 취소되었습니다 |
node_request_decided | 노드 추가 요청 처리 | 노드 추가 요청(코드)이 처리되었습니다 |
승인 알림 본문에 확정 차감액이 함께 온다. 반려 알림에는 사유가 함께 온다.
서버리스
| kind | 언제 | 제목 |
|---|---|---|
key_ready | 키 발급됨 | 서버리스 API 키가 준비되었습니다 — 서버리스에서 수령하세요 |
model_access_granted | 모델 접근 허용 | 모델 접근이 허용되었습니다: {모델} |
request_rejected | 요청 반려 | {코드} 요청이 반려되었습니다 |
시스템
| kind | 언제 | 제목 |
|---|---|---|
launch_failed | 기동 실패 | 인스턴스 기동에 실패했습니다 |
launch_failed | 가용 노드 없음 | {유형} 가용 노드가 없어 시작하지 못했습니다 |
launch_failed | 세션 개시 실패 | 세션 개시에 실패해 시작을 취소했습니다 |
force_stopped | 관리자 강제 중지 | 관리자가 인스턴스를 강제 중지했습니다 |
export_ready | CSV 생성 완료 | CSV 내보내기가 완료되었습니다 (n행) |
Org Admin에게
| kind | 언제 | 제목 |
|---|---|---|
credits_purchased | Super Admin이 크레딧 판매 | 크레딧 n C가 반영되었습니다 |
team_locked | 소속 팀이 잠김 | 팀 크레딧 소진 — 자동 잠금됨 |
team_locked 본문: 예산을 증액하면 즉시 잠금이 해제됩니다.
Org Admin은 팀의 모든 알림을 받지 않는다. 조치가 필요한 것만 온다. 나머지는 사용 로그와
팀 관리 화면에서 확인한다.
Super Admin에게
처리가 필요한 것
| kind | 언제 | 제목 |
|---|---|---|
request_created | 팀이 요청을 보냄 | {팀} · {요청 종류} |
adjustment_accepted | 조정안 수락됨 | 조정안이 수락되어 예약이 확정되었습니다 |
adjustment_declined | 조정안 거절됨 | 조정안이 거절되었습니다 |
adjustment_expired | 조정안 무응답 만료 | 조정안이 무응답으로 만료되었습니다 |
reservation_auto_rejected | 승인 후 확정 차감 실패 | 예약 승인이 반려로 끝났습니다 |
조정안 관련 알림이 세 개나 있는 이유는 명확하다. 조정안을 회신하면 그 건은 승인 큐에서 사라진다. 결말을 알림으로 알리지 않으면 운영은 물량 확보 계획을 언제 접어야 할지 모른다.
수동 조치가 필요한 것
| kind | 언제 | 제목 |
|---|---|---|
stop_failed | 중지 명령 실패 | 인스턴스 중지 명령 실패 — 세션 유지 |
stop_unconfirmed | 중지 미확인 | 인스턴스 중지 미확인 — 정산·노드 반환 보류 |
activation_failed | 확정 차감 후 자원 미배정 | 예약 {코드} 활성화 실패 — 수동 조치 필요 |
partial_activation | 예약 노드 일부만 배정됨 | 예약 {코드} 부분 미배정 — n/m |
reconciliation_violation | 정합성 위반 감지 | 정합성 위반 감지 — 원장 n건 · 세션 m건 |
이 다섯은 자동으로 해결되지 않는다. 특히 activation_failed는 돈은 받았는데 자원을
못 준 상태라 즉시 조치가 필요하다.
어떤 일에 알림이 안 가는가
정상 경로 중 일부는 알림 없이 화면 상태로만 반영된다.
| 일어난 일 | 알림 | 대신 어디서 |
|---|---|---|
| 인스턴스 정상 시작·중지 | ❌ | 인스턴스 목록·사용량 리포트 |
| 서버리스 호출 성공 | ❌ | 키 사용 게이지 |
| 팀 예산 변경 | ❌ | 대시보드 잔여 |
| 노드 등록·해제 | ❌ | 조직 노드 풀 |
| 멤버 비활성화 | ❌ | 로그인 시 차단으로 알게 된다 |
기준은 하나다. 사용자가 화면을 보고 있지 않을 때 알아야 하는 일에만 알림이 간다. 화면을 열면 바로 보이는 것은 알림으로 중복해서 보내지 않는다.
알림 밖의 채널
웹훅 조직 설정에서 https URL을 등록하면 알림이 함께 전송된다. 내부·사설 주소는 거부된다
(webhook_internal).
감사 로그 알림이 가지 않는 일도 로그에는 전부 남는다. 추적은 감사 로그에서 한다.