← Cloudflare Email Service / email-service / observability
Журналы писем
Email Service ведёт подробные журналы отправки и маршрутизации писем. Открывайте детальные журналы в панели управления Cloudflare, чтобы отслеживать движение писем, устранять проблемы с доставкой и анализировать статус аутентификации.
Activity log
Журнал активности позволяет просматривать все действия с электронной почтой и проверять операции, выполненные Email Service. В панели управления можно отфильтровать журнал активности по периоду от 30 минут до 30 дней или задать произвольный диапазон.
Журнал активности отображает те же данные по каждому событию, что также доступны программно через emailSendingAdaptive и emailRoutingAdaptive наборы данных в GraphQL Analytics API.
В Email Routing можно развернуть отдельное письмо в журнале Activity log, чтобы проверить результаты аутентификации (SPF ↗, DKIM ↗, а также DMARC ↗).
Журналы отправки писем
Для исходящих писем, отправленных через Email Service:
- Отправлено: Письмо успешно принято и поставлено в очередь на доставку.
- Доставлено: Письмо успешно доставлено на почтовый сервер получателя.
- Доставка не выполнена: Письмо вернулось отправителю (жесткий или мягкий отказ). Это соответствует
deliveryFailedстатус в GraphQL Analytics API. - Отклонено: Письмо не было отправлено, поскольку получатель добавлен в список подавления.
- Сбой: Не удалось отправить письмо из-за проблем с настройками или аутентификацией.
Журналы маршрутизации писем
Для входящих писем, обрабатываемых через Email Routing:
- Переслано: Письмо успешно переслано на целевой адрес.
- Обработано: Письмо обработано обработчиком Worker.
- Отклонено: Письмо отклонено из-за правил фильтрации или настроек.
- Отклонено: Письмо отклонено из-за ошибок проверки SPF, DKIM или DMARC.
- Доставка не выполнена: Не удалось доставить письмо на адрес получателя.
- Ошибка: Не удалось обработать письмо из-за внутренней ошибки.
Просмотр сведений о письме
Выберите любое письмо в журнале Activity log, чтобы развернуть подробности и увидеть информацию об аутентификации и доставке.
Статус аутентификации
Проверьте статус протоколов аутентификации почты:
- Статус SPF: Показывает pass/fail для проверки Sender Policy Framework.
- Статус DKIM: Показывает pass/fail для проверки подписи DomainKeys Identified Mail.
- Статус DMARC: Показывает pass/fail для соответствия Domain-based Message Authentication.
Информация о доставке
Для отправленных писем см. сведения о доставке:
- Ответ почтового сервера получателя.
- Попытки доставки и временные метки.
- Коды причин и категории отказов.
- Итоговый статус доставки.
Предпросмотр сообщения
Для отправленных писем разверните письмо в журнале Activity log, чтобы открыть Предпросмотр разделе и просмотреть сообщение в том виде, в котором оно было отправлено. Предпросмотр включает следующие вкладки:
- HTML: Отрендеренное HTML-тело письма.
- Текст: Текстовое тело письма.
- Headers: Заголовки сообщения.
- Вложения: Файлы, вложенные в сообщение.
- Raw: Полное необработанное RFC 5322 ↗ исходное сообщение.
Чтобы можно было просматривать отправленные сообщения, включите Предпросмотр писем для домена отправки. Предпросмотр охватывает письма, отправленные при включённой настройке, и хранится около семи дней. Новые домены отправки имеют Предпросмотр писем включается автоматически.
Рекомендации по мониторингу журналов
Регулярная проверка
- Ежедневно проверяйте журналы на начальном этапе настройки
- Проверяйте еженедельно в рамках текущей эксплуатации
- Проверяйте сразу после изменения конфигурации
Ключевые метрики для отслеживания
- Частота сбоев аутентификации
- Закономерности и тенденции отказов
- Доля успешных доставок
Порядок устранения неполадок
- Определите проблему: используйте журналы, чтобы точно определить тип сбоя
- Проверьте аутентификацию: проверьте настройки SPF, DKIM, DMARC
- Скорректируйте конфигурацию: внесите необходимые изменения в DNS или маршрутизацию
- Отслеживайте улучшения: анализируйте метрики после изменений
Журналы писем дают наглядность, необходимую для поддержания высокой доставляемости и правильной маршрутизации входящих писем. Используйте эти данные, чтобы оптимизировать настройки почты и быстро устранять проблемы с доставкой.