SendGrid 이메일 로그는 조용히 유용합니다 — 그래서 저는 그것에 대해 씁니다
Source: Dev.to
Overview
웹 애플리케이션에 이메일 전송을 구현하면 다음과 같은 질문에 직면하게 됩니다:
- 이 이메일이 실제로 전송되었나요?
- 왜 특정 사용자가 받지 못했나요?
이러한 조사는 정기적으로 발생합니다. 경우에 따라 관리 패널의 전송 통계만으로 충분할 수 있지만, 이메일이 언제 전송되었는지, 어떤 상태로 끝났는지, 반송되었는지 열렸는지와 같은 세부 정보를 추적하는 일은 생각보다 번거로운 작업이 될 수 있습니다.
최근에 SendGrid가 Email Logs 라는 기능을 추가한 것을 발견했습니다(정확히 언제 출시됐는지는 모르겠습니다). 이 기능을 다룬 글이 많지 않아, 이번 포스트에서는 실제 운영에서 Email Logs가 어떻게 유용한지에 초점을 맞추겠습니다.
What Are Email Logs?
Email Logs는 SendGrid를 통해 전송된 개별 이메일을 검사하고 대시보드에서 직접 상태를 확인할 수 있게 해줍니다. 상태에는 다음이 포함됩니다:
- Sent (전송됨)
- Delivered (전달됨)
- Bounced (반송됨)
- Dropped (삭제됨)
Stats가 집계 데이터를 위한 것이라면, Email Logs는 단일 이메일의 히스토리를 추적할 수 있게 해줍니다.
Difference from Activity Feed
SendGrid에는 이미 Activity Feed 라는 유사한 기능이 있지만 몇 가지 제한이 있습니다:
- 무료 플랜에서는 기록이 3일 또는 7일로 제한됨
- 최근 30일 기록을 보려면 유료 플랜이 필요함
Email Logs는 최대 1,000개의 항목이라는 제한이 있지만, 대시보드에서 지난 30일 동안 전송된 이메일 목록을 바로 확인할 수 있습니다.
Why This Is Useful

Email Logs는 다음과 같은 조건으로 필터링할 수 있습니다:
- 수신자 이메일 주소
- Message ID
- 상태 (Delivered / Bounced 등)
- 시간 범위
이를 통해 **“어제 이 사용자에게 보낸 이메일”**을 몇 초 만에 찾아낼 수 있습니다.

지원팀이나 내부 점검 시 흔히 묻는 질문 — “그 이메일이 정말 전송됐나요?” — 에 대해 Email Logs를 사용하면 거의 즉시 답을 얻을 수 있습니다.
Summary
Email Logs는 화려한 새 기능은 아니지만, 일상적인 운영에서 마찰을 크게 줄여줍니다. 특히 다음과 같은 경우에 유용합니다:
- 사고 발생 시 초기 조사
- 고객 지원과 엔지니어 간 빠른 확인
- 프로덕션 환경에서 이메일 전송 여부 검증
SendGrid를 사용하고 있다면, 이 기능을 한 번 살펴볼 가치가 충분합니다.