Skip to main content
알림 시스템은 예약 작업 결과를 이메일과 웹훅을 통해 자동으로 전달합니다. 관리자가 알림 채널을 사전 구성하면, 사용자는 예약 작업 생성 시 채널을 선택하여 결과 알림을 받을 수 있습니다.

​
알림 아키텍처

단계담당설명
채널 설정관리자SMTP, SendGrid, Slack 등 채널 사전 구성
채널 선택사용자예약 작업에서 알림 채널과 트리거 조건 지정
알림 발송시스템예약 작업 실행 후 결과를 선택된 채널로 전달

​
이메일 채널

관리자 > 설정 > 알림 또는 별도 알림 관리 화면에서 이메일 채널을 추가합니다. 여러 채널을 등록하여 팀별로 다른 발신 설정을 사용할 수 있습니다.

​
채널 추가

”+ 이메일 채널 추가” 버튼을 클릭합니다.
필드설명
채널 이름식별 이름 (예: “기본”, “마케팅팀 메일”)
엔진SMTP 또는 SendGrid 선택

​
SMTP 설정

사내 메일 서버 또는 외부 SMTP 서비스(Gmail, Outlook 등)를 연결합니다.
설정설명예시
서버SMTP 서버 주소smtp.gmail.com
포트SMTP 포트587 (TLS) / 465 (SSL)
사용자명인증 계정noreply@company.com
비밀번호인증 비밀번호
TLS 사용TLS 암호화 활성화포트 587에서 사용
SSL 사용SSL 암호화 활성화포트 465에서 사용
발신자 주소From 이메일 주소noreply@company.com
발신자 이름From 이름Cloosphere
TLS와 SSL은 동시에 사용할 수 없습니다. 포트 587에는 TLS, 포트 465에는 SSL을 사용하세요.

​
연결 테스트

“연결 테스트” 버튼으로 메일 서버 연결 상태를 확인합니다.
결과설명
성공서버 연결, 인증 모두 정상
인증 실패사용자명/비밀번호 확인 필요
연결 실패서버 주소, 포트, 방화벽 확인 필요
타임아웃네트워크 연결 확인 필요

​
테스트 이메일 발송

“테스트 이메일 발송” 버튼으로 실제 이메일 수신을 확인합니다.
1

수신자 이메일 입력

테스트 이메일을 받을 주소를 입력합니다.
2

발송 클릭

“발송” 버튼을 클릭합니다.
3

수신 확인

받은 편지함(스팸함 포함)에서 테스트 이메일 수신을 확인합니다.

​
웹훅 채널

외부 메시징 서비스와 연동하여 알림을 전송합니다.

​
채널 추가

”+ 웹훅 채널 추가” 버튼을 클릭합니다.
필드설명
채널 이름식별 이름 (예: “개발팀 Slack”)
제공자Slack / Teams / Discord / Telegram
웹훅 URL제공자에서 발급받은 수신 웹훅 URL

​
제공자별 설정

웹훅 URL 생성:
  1. Slack 앱 관리 페이지에서 Incoming Webhooks 활성화
  2. Add New Webhook to Workspace 클릭
  3. 채널 선택 후 Allow
  4. 생성된 URL 복사 (https://hooks.slack.com/services/...)
알림 형식: Header 블록 + Fields (프롬프트, 완료 시간) + Section (결과) + 차트 이미지

​
테스트 웹훅

“테스트” 버튼을 클릭하면 선택한 제공자 형식에 맞는 테스트 메시지를 전송합니다.

​
예약 작업 알림 연동

관리자가 채널을 설정한 후, 사용자는 예약 작업에서 알림을 구성합니다.

​
트리거 조건

조건설명사용 사례
항상성공/실패 모두 알림중요 스케줄 모니터링
성공 시만정상 완료 시에만 알림정기 보고서 전달
실패 시만오류 발생 시에만 알림장애 감지 알림

​
다중 알림

하나의 예약 작업에 여러 알림 채널을 동시에 설정할 수 있습니다.
알림채널대상조건
알림 1이메일팀장항상
알림 2Slack 웹훅개발팀 채널실패 시만
알림 3Teams 웹훅경영진 채널성공 시만

​
차트 이미지 전달

DbSphere 에이전트가 생성한 Plotly 차트는 서버사이드 렌더링으로 PNG 이미지로 변환되어 알림에 포함됩니다.
채널방식설명
이메일인라인 Base64본문에 이미지 직접 포함
Slack이미지 URL이미지 블록으로 표시
TeamsAdaptive Card카드 내 이미지 요소
DiscordEmbed 이미지첫 번째 차트만 포함
차트 이미지는 알림 발송 전에 자동으로 추출됩니다. 알림 본문에서는 차트 마커가 제거되어 깔끔한 텍스트가 전달됩니다.

​
트러블슈팅

증상확인 사항
연결 실패서버 주소, 포트 확인. 방화벽에서 SMTP 포트 허용 여부 확인
인증 실패사용자명/비밀번호 확인. Google은 앱 비밀번호 사용 필요
이메일 미수신수신자 스팸함 확인. 발신 도메인의 SPF/DKIM 설정 확인
TLS 오류TLS/SSL 설정과 포트 조합 확인 (587-TLS, 465-SSL)
SendGrid 오류API 키 권한 확인. 발신자 주소가 인증되었는지 확인
증상확인 사항
전송 실패웹훅 URL 유효성 확인. URL이 만료되지 않았는지 확인
메시지 미표시대상 채널/앱의 권한 확인. 봇이 채널에 접근 가능한지 확인
타임아웃네트워크 연결 확인. 방화벽에서 외부 HTTPS 요청 허용 여부
형식 깨짐제공자 설정 확인 (Slack/Teams/Discord/Telegram 중 올바른 항목 선택)
증상확인 사항
알림이 오지 않음예약 작업의 알림 설정 확인. 트리거 조건이 올바른지 확인
차트 이미지 없음에이전트가 DbSphere와 연결되어 있는지 확인