---
title: 日志与导出
description: 查找任意一封邮件或 API 请求，了解它经历了什么，并把你的数据下载为 CSV。
ai:
  exclude: true
---

有三个工具可以帮你回答「这封邮件发生了什么？」：邮件列表、API 请求日志和 CSV 导出。

## 邮件

在控制台中，**邮件** 页面列出你的团队发送的每一封邮件。可以按收件人、主题或邮件 ID 搜索，也可以按状态、API 密钥、品牌（发信域名）、来源（事务邮件或群发）和时间范围筛选。

打开一封邮件可以看到：

- 按顺序排列的事件：已发送、已送达、已延迟、已退信、已打开、已点击等，以及延迟或退信的原因；
- 邮件发出时的内容（预览、HTML 或纯文本）和邮件头；
- 对尚未发出的邮件，显示它在等待的原因（套餐限制、预热、安全检查等）；
- 它的 [送达率洞察](/docs/zh-hans/concepts/deliverability-insights) 评分。

通过 API，`GET /emails` 列出邮件（最新的在前，使用游标分页），`GET /emails/{id}` 返回一封邮件及其最新事件。两者都需要完全访问权限的 API 密钥。想在事件发生时就收到推送，请使用 [Webhook](/docs/zh-hans/concepts/webhooks)。

所有套餐的邮件正文和历史记录都保存 30 天，之后删除。

## API 请求日志

控制台中的 **日志** 页面列出最近 30 天内，用你的 API 密钥或通过 MCP 发出的每一个请求。每行显示状态、方法、路径、发出请求的密钥或已连接的应用，以及时间。

- 可以按路径、密钥或请求 ID 搜索。可以按来源（API 密钥或 MCP）、API 密钥、状态类别（`2xx`、`4xx`、`5xx`）和时间范围筛选。
- 打开一行可以查看请求和响应的内容，方便查明某次调用为什么返回 `422` 或 `403`。
- 只有 JSON 格式且小于 64 KB 的内容才会被保存。邮件内容（`html`、`text`）会被替换为它的大小，令牌、密码等机密信息显示为 `[redacted]`，请求头从不保存。
- 只有所有者、管理员和开发者能看到内容。

## 导出为 CSV

列出你的数据的页面都有 **导出 CSV** 按钮。文件带有你已应用的筛选条件，所以和屏幕上显示的内容一致。一次导出最多包含 50,000 行，最新的在前。导出使用你的控制台登录身份，所以没有对应的 API 接口。

可以导出什么取决于你的 [团队角色](/docs/zh-hans/team-roles)：

| 导出内容 | 位置 | 角色 |
| --- | --- | --- |
| 联系人、退订、群发收件人 | 联系人页面，以及群发自己的页面 | 所有者、管理员、营销 |
| 域名、API 密钥、API 请求日志 | 各自的页面 | 所有者、管理员、开发者 |
| 邮件、抑制列表、审计日志 | 邮件、联系人 → 抑制列表、设置 | 所有者、管理员 |

请求日志导出的列有 `request_id`、`created_at`、`method`、`path`、`status`、`duration_ms` 和 `caller`。联系人导出包含 `unsubscribed` 列和 `unsubscribed_domains` 列（`*` 表示整个团队）。

## 删除某个人的数据

要从历史记录中移除某位收件人，请带上 `erase: true` 删除该联系人，详见 [联系人](/docs/zh-hans/concepts/contacts)。这也会从邮件历史、事件载荷和 API 请求日志中移除该地址。
