邮件日志

Email Service 为邮件发送和路由活动提供全面的日志记录。可通过 Cloudflare 仪表板访问详细日志，以监控邮件流转、排查投递问题，并分析身份验证状态。

活动日志（Activity log）可让你浏览所有邮件活动，并查看 Email Service 采取的操作。在仪表板中，可将活动日志筛选为 30 分钟到 30 天的时间范围，或指定自定义范围。

活动日志展示的每条事件数据，与通过 GraphQL Analytics API 中的 emailSendingAdaptive 和 emailRoutingAdaptive 数据集 以编程方式获取的数据相同。

对于 Email Routing，可在活动日志中展开单封邮件，检查身份验证结果（SPF ↗、DKIM ↗ 和 DMARC ↗）。

对于通过 Email Service 发送的出站邮件：

• Sent（已发送）：邮件已成功接受并排队等待投递。
• Delivered（已投递）：邮件已成功投递到收件人的邮件服务器。
• Delivery failed（投递失败）：邮件被退回（硬退回或软退回）。这对应于 GraphQL Analytics API 中的 deliveryFailed 状态。
• Rejected（已拒绝）：邮件未发送，因为收件人在你账户的抑制列表中。
• Failed（失败）：由于配置或身份验证问题，邮件发送失败。

对于通过 Email Routing 处理的入站邮件：

• Forwarded（已转发）：邮件已成功转发到目标地址。
• Handled（已处理）：邮件已由 Worker 处理程序处理。
• Dropped（已丢弃）：邮件因过滤规则或配置被丢弃。
• Rejected（已拒绝）：邮件因 SPF、DKIM 或 DMARC 失败被拒绝。
• Delivery failed（投递失败）：邮件无法投递到目标地址。
• Error（错误）：由于内部错误，邮件无法处理。

在活动日志中选择任意邮件可展开其详情，查看身份验证和投递信息。

检查邮件身份验证协议的状态：

• SPF status（SPF 状态）：显示 Sender Policy Framework 验证的通过/失败。
• DKIM status（DKIM 状态）：显示 DomainKeys Identified Mail 签名验证的通过/失败。
• DMARC status（DMARC 状态）：显示 Domain-based Message Authentication 合规性的通过/失败。

对于已发送的邮件，可查看投递详情：

• 收件人邮件服务器响应。
• 投递尝试次数和时间戳。
• 退回原因代码和类别。
• 最终投递状态。

对于已发送的邮件，在活动日志中展开邮件可打开 Preview（预览） 部分，检查发送时的消息内容。预览提供以下选项卡：

• HTML：渲染后的 HTML 正文。
• Text（文本）：纯文本正文。
• Headers（标头）：消息标头。
• Attachments（附件）：消息附带的文件。
• Raw（原始）：完整的原始 RFC 5322 ↗ 消息源。

要让已发送的消息可预览，请为发送域启用 Email preview（邮件预览）。预览涵盖该设置开启期间发送的消息，并保留约七天。新的发送域默认自动启用 Email preview（邮件预览）。

• 初始设置期间每天监控日志
• 日常运营中每周检查
• 配置变更后立即审查

• 身份验证失败率
• 退回模式与趋势
• 投递成功率

1. 识别问题：使用日志定位失败类型
2. 检查身份验证：验证 SPF、DKIM、DMARC 配置
3. 调整配置：进行必要的 DNS 或路由更改
4. 监控改进：在更改后跟踪指标

邮件日志提供了维持高投递率并正确路由入站邮件所需的可见性。使用这些数据优化邮件配置，并快速解决任何投递问题。