알람알림 관리
개요
이 화면은 무엇인가요?
알람 발생 시 담당자에게 전송된 알림의 발송 상태와 이력을 확인하는 화면입니다. 이메일, SMS, 메신저, 인앱 알림의 발송 성공/실패 여부를 추적하고, 발송 실패 시 재시도 상태를 관리합니다.
누가 사용하나요?
- IoT 엔지니어: 알림 발송 실패 확인, 채널별 발송 상태 점검
언제 사용하나요?
- 알람이 발생했는데 담당자가 알림을 받지 못했다고 할 때
- 특정 알림 채널(SMS 등)의 발송 실패가 반복될 때
- 알림 발송 이력을 감사(audit) 목적으로 확인할 때
주요 기능
- 발송 상태 추적: pending(대기) / sent(발송) / failed(실패) 상태 관리
- 다채널 이력: 이메일, SMS, 메신저, 인앱 알림별 이력 조회
- 재시도 관리: 발송 실패 시 재시도 횟수 및 에러 메시지 확인
- 열람 확인: 인앱 알림의 수신자 열람 시각 추적
목록 화면 설정
표시 컬럼
| 컬럼 | 표시 형태 | 정렬 |
|---|---|---|
| 알림코드 | 링크 | ✅ |
| 이벤트 | 텍스트 | ✅ |
| 규칙 | 텍스트 | ✅ |
| 수신자 | 텍스트 | ✅ |
| 알림채널 | 태그 | ✅ |
| 발송상태 | 배지 (녹/노/적) | ✅ |
| 발송시각 | 날짜/시간 | ✅ |
| 에러메시지 | 텍스트 | ✅ |
검색/필터
| 필드 | 필터 유형 | 설명 |
|---|---|---|
| 알림코드 | 텍스트 검색 | 코드로 빠르게 찾기 |
| 알림 채널 | 드롭다운 선택 | email/sms/messenger/in_app |
| 발송상태 | 드롭다운 선택 | pending/sent/failed |
| 발송시각 | 날짜 범위 | 기간별 조회 |
자주 묻는 질문 (FAQ)
알림 발송이 실패(failed)했습니다. 어떻게 하나요?
- 에러메시지 확인: 해당 알림의 에러메시지 항목에서 실패 원인을 확인합니다
- 일반적인 원인:
- email: SMTP 서버 연결 실패, 수신자 이메일 주소 오류
- sms: SMS 서비스 크레딧 부족, 수신자 번호 오류
- messenger: 메신저 API 키 만료, 웹훅 URL 변경
- 문제를 해결한 후 알림 시스템은 자동으로 재시도합니다 (재시도횟수 확인)
인앱 알림을 수신자가 읽었는지 확인할 수 있나요?
네, 열람시각(read_at) 항목에서 수신자가 인앱 알림을 열어본 시각을 확인할 수 있습니다. 값이 비어 있으면 아직 미열람입니다.
참고: 데이터 구조
알람알림 테이블 (alarm_notifications)
| 컬럼명 | 한글명 | 타입 | 설명 |
|---|---|---|---|
notification_code | 알림코드 | VARCHAR *필수 *고유 | - |
event_id | 이벤트ID | UUID (FK) *필수 | alarm_events 참조 |
rule_id | 규칙ID | UUID (FK) | alarm_rules 참조 |
channel | 알림채널 | ENUM *필수 | email/sms/messenger/in_app |
recipient_id | 수신자ID | UUID (시스템참조) | - |
sent_at | 발송시각 | TIMESTAMP | - |
status | 발송상태 | ENUM *필수 | pending/sent/failed |
message_content | 알림내용 | TEXT | - |
error_message | 에러메시지 | TEXT | 발송 실패 시 원인 |
retry_count | 재시도횟수 | INT | - |
read_at | 열람시각 | TIMESTAMP | 인앱 알림 열람 시각 |