통신 발송 로그

통신 발송 로그는 관리자가 메시지 발송 이력, 제공업체 활동, 발송 결과, 수신자 정보, 제공업체 응답 정보를 확인할 수 있는 기능입니다.

이메일, SMS, 알림, 인증 메시지, 청구서, 기타 통신 메시지가 정상적으로 발송되었는지 확인할 때 사용합니다.

화면 개요

Send Logs 화면은 Message Center, 시스템 이벤트, 템플릿, 제공업체, 자동 발송 처리에서 생성된 통신 이력을 기록합니다. 관리자는 이 화면을 통해 발송 결과를 확인하고 발송 실패 원인을 추적할 수 있습니다.

영역	설명
검색 필터	Provider, Template, Channel, Status, Page Size 기준으로 발송 로그를 필터링합니다.
로그 요약	전체 로그 수, 현재 페이지 정보, 페이지 크기를 보여줍니다.
발송 로그 목록	검색 조건에 맞는 발송 로그와 발송 상태 정보를 보여줍니다.

검색 필터

검색 필터는 통신 로그를 조건별로 좁혀 볼 수 있게 해줍니다. 발송 실패를 조사하거나, 특정 제공업체 사용 내역을 확인하거나, 특정 템플릿의 발송 이력을 검토할 때 유용합니다.

필터	설명
Provider	SMTP, SendGrid, Twilio 등 메시지 발송에 사용된 통신 제공업체로 필터링합니다.
Template	메시지 발송에 사용된 통신 템플릿으로 필터링합니다.
Channel	Email 또는 SMS 같은 채널로 필터링합니다.
Status	성공, 실패, 대기 등 발송 상태 기준으로 필터링합니다.
Page Size	한 페이지에 표시할 로그 수를 설정합니다.
Search	선택한 검색 조건을 적용하여 로그 목록을 다시 조회합니다.

요약 카드

요약 카드는 현재 조회 결과를 빠르게 확인할 수 있게 해줍니다.

카드	설명
Total Logs	현재 검색 조건에 맞는 전체 로그 수를 보여줍니다.
Current Page	현재 페이지 번호와 전체 페이지 수를 보여줍니다.
Page Size	한 페이지에 표시되는 로그 수를 보여줍니다.

발송 로그 목록

Send Log List는 실제 발송 이력을 보여줍니다. 각 행은 하나의 메시지 발송 시도 또는 통신 기록을 의미합니다.

컬럼	설명
ID	내부 로그 ID입니다.
Provider	메시지 발송에 사용된 통신 제공업체입니다.
Template	메시지에 사용된 템플릿입니다. 템플릿 없이 발송된 경우 비어 있을 수 있습니다.
Channel	Email 또는 SMS 같은 통신 채널입니다.
To	수신자 이메일 주소, 전화번호 또는 대상 값입니다.
Subject	메시지 제목입니다. 주로 이메일 메시지에서 사용됩니다.
Status	발송 결과 또는 처리 상태입니다.
Sent	메시지가 발송되었거나 발송을 시도한 날짜와 시간입니다.
Created	로그 기록이 생성된 날짜와 시간입니다.

일반적인 상태 의미

Status 값은 구현 방식이나 제공업체 응답에 따라 달라질 수 있습니다. 일반적으로는 아래와 같은 의미로 사용됩니다.

상태	의미
Ready	메시지가 준비되었지만 아직 발송되지 않은 상태입니다.
Pending	메시지가 처리 대기 중이거나 제공업체 확인을 기다리는 상태입니다.
Sent	시스템에서 제공업체로 메시지 발송 요청을 보낸 상태입니다.
Success	제공업체가 메시지 요청을 성공적으로 수락하거나 처리한 상태입니다.
Failed	제공업체 오류, 잘못된 설정, 잘못된 수신자 또는 기타 문제로 발송 실패한 상태입니다.
Error	발송 처리 중 내부 오류 또는 예외가 발생한 상태입니다.

권장 작업 순서

Admin > Provider > Send Log 메뉴로 이동합니다.
특정 제공업체의 발송 내역을 보려면 Provider를 선택합니다.
특정 템플릿의 발송 이력을 보려면 Template을 선택합니다.
Email 또는 SMS 같은 Channel을 선택합니다.
실패 또는 성공 메시지를 확인하려면 Status를 선택합니다.
Page Size를 선택합니다.
Search 버튼을 클릭합니다.
Send Log List를 확인합니다.
발송 실패가 있다면 관련 Provider와 Template 설정을 확인합니다.

실패한 메시지 확인 방법

메시지 발송이 실패한 경우 Send Logs 화면에서 사용된 제공업체, 템플릿, 채널, 수신자, 제목, 발송 시간을 확인할 수 있습니다.

Status를 Failed 또는 Error로 선택합니다.
Search 버튼을 클릭합니다.
어떤 Provider가 사용되었는지 확인합니다.
수신자 이메일 주소 또는 전화번호가 올바른지 확인합니다.
관련 Template과 Provider 설정을 확인합니다.
필요하면 Provider에서 Send Test를 실행합니다.

자주 사용하는 작업

작업	권장 방법
이메일이 발송되었는지 확인	Provider, Email 채널, 수신자 정보를 기준으로 확인합니다.
실패한 SMS 찾기	Channel을 SMS로 선택하고 Status를 Failed 또는 Error로 선택합니다.
템플릿 사용 내역 확인	Template을 선택하고 로그 목록을 조회합니다.
제공업체 사용 내역 확인	Provider를 선택하고 해당 제공업체의 발송 로그를 확인합니다.
최근 통신 활동 감사	상태, 제공업체, 생성일 기준으로 로그를 확인합니다. 날짜 필터가 있다면 함께 사용합니다.

다른 통신 기능과의 관계

기능	관계
Provider	Provider는 메시지를 어떻게 발송할지 결정합니다. Provider 설정이 잘못되면 실패 로그가 생성될 수 있습니다.
Template	Template은 메시지 제목과 본문을 결정합니다. 템플릿이 잘못되면 내용이 깨지거나 변수가 누락될 수 있습니다.
Message Center	Message Center에서 수동으로 발송한 메시지는 Send Log에 기록될 수 있습니다.
Event-Based Sending	시스템 이벤트로 자동 발송된 메시지도 Send Log에 기록될 수 있습니다.

문제 해결

문제	가능한 원인	해결 방법
로그가 보이지 않음	아직 발송된 메시지가 없거나 검색 조건이 너무 제한적일 수 있습니다.	검색 조건을 초기화하고 다시 조회합니다.
메시지 발송 실패	Provider가 비활성 상태이거나 설정이 잘못되었거나 인증 정보가 누락되었을 수 있습니다.	Provider 설정을 확인하고 Send Test를 실행합니다.
이메일은 발송되었지만 수신되지 않음	스팸 처리, 수신 서버 차단, 발신자 인증 문제 등이 있을 수 있습니다.	Provider 응답, 발신자 인증, SPF, DKIM, DMARC, 스팸함을 확인합니다.
SMS 발송 실패	전화번호 형식이 잘못되었거나 Account Token이 잘못되었거나 벤더가 요청을 거부했을 수 있습니다.	전화번호 형식, Provider 인증 정보, 벤더 응답을 확인합니다.
잘못된 템플릿 내용이 발송됨	잘못된 템플릿이 선택되었거나 이벤트에 잘못 연결되었을 수 있습니다.	Template 설정과 이벤트/템플릿 매핑을 확인합니다.
변수가 치환되지 않음	템플릿에 지원되지 않거나 오타가 있는 변수가 포함되었을 수 있습니다.	해당 발송 처리에서 지원하는 변수를 사용합니다.

주의사항

Send Log는 발송 이력 확인과 문제 해결을 위해 사용합니다.
로그 기록이 있다고 해서 수신자가 메시지를 읽었다는 의미는 아닙니다.
Provider가 요청을 수락한 것과 최종 수신 성공은 다를 수 있습니다.
일부 제공업체는 요청을 수락한 후 나중에 발송을 거절할 수 있습니다.
실패한 메시지는 Provider 설정과 함께 확인해야 합니다.
로그에는 수신자 정보가 포함될 수 있으므로 권한 있는 관리자만 접근하도록 제한해야 합니다.

관리 권장 사항

실패 로그를 정기적으로 확인하세요.
Provider 설정을 최신 상태로 유지하세요.
운영 메시지에는 테스트된 템플릿을 사용하세요.
SMTP, SendGrid, Twilio 등 제공업체 설정 변경 후에는 발송 실패가 없는지 확인하세요.
전체 로그를 한 번에 보기보다 필터를 사용해 필요한 로그만 확인하세요.
로그에는 이메일 주소, 전화번호, 메시지 제목이 포함될 수 있으므로 접근 권한을 보호하세요.

통신 발송 로그는 발송 활동을 확인하고 메시지 실패 원인을 찾는 데 매우 중요합니다. 사용자가 메시지를 받지 못했다고 보고하면 가장 먼저 확인해야 할 화면 중 하나입니다.