# 数据保留、导出与删除

来源: https://platform.lyrouter.com/ai_gateway/docs/retention
更新日期: 2026-10-22

日志正文（对话、原始报文、路由候选与尝试记录）可以查看多少天，由账户的订阅决定；超过留存期后，日志只保留元数据。日志记录本身最多保存 180 天，之后自动删除。需要长期留存时，由当前账号管理员或工作空间管理员在留存期内按时间范围加密导出，导出文件保留 24 小时。

## 查看留存期

在工作空间的 **日志分析** 页点击 **日志存储设置**，「日志详情存储策略」顶部显示当前账户的「滚动容量：N 条详情」和「详情留存：N 天」。这两个数值来自账户的订阅，各套餐的「日志详情条数」和「日志留存」显示在 **订阅充值** 页的套餐卡片上，见[计费规则与信用点](https://platform.lyrouter.com/ai_gateway/docs/billing)。

（截图：日志详情存储策略显示当前的滚动容量和详情留存天数。）

| 内容 | 可以查看多久 |
| --- | --- |
| 元数据：时间、API Key、模型、服务商、状态码、Token、费用、耗时等 | 180 天，之后整条日志自动删除 |
| 正文：「对话」「原始报文」、路由追踪中的候选和上游调用尝试、安全审查命中记录 | 订阅的「详情留存」天数内 |
| 导出文件 | 创建导出任务后 24 小时 |

- **超过留存期**：日志仍在列表中，元数据可以查看；详情标注「详情已超过留存期」，并提示「该请求的元数据仍可查看，但内容详情已超过当前版本的 N 天留存期。」
- **按当前订阅计算**：留存期按查看时账户的订阅计算，订阅变化后，可以查看正文的时间范围随之变化。
- **没有保存正文的日志**：工作空间没有开启全文日志时，日志本来就只有元数据，详情显示「本条日志未记录正文」，见[日志内容与数据处理](https://platform.lyrouter.com/ai_gateway/docs/privacy)。
- **滚动容量与超容**：「滚动容量」是订阅包含的日志详情条数，按账户计算，账户内所有开启全文日志的工作空间共用，只统计开启之后的新请求；超出容量的较早正文约每天清理一次。运营为套餐设置了超容单价时，弹窗中才会出现「超容后付费保留」开关：开启后超出容量的正文不再清理，按弹窗显示的单价从实付额度扣费。这个开关作用于整个账户，在任一工作空间修改都会影响同一账户的所有工作空间；修改后点击 **保存**。目前各套餐默认没有超容单价，不显示这个开关。

## 加密导出

当前账号管理员和工作空间管理员可以把日志导出为加密文件，其他成员的 **导出** 按钮不可用。「最近导出任务」只列出你自己在当前工作空间创建的任务，也只有创建人可以下载。

1. 在 **日志分析** 页设置好搜索词和筛选条件，导出会沿用它们（时间范围除外）。
2. 点击 **导出**，打开「日志导出」。
3. 「导出格式」选择 CSV 或 JSON，默认 JSON。
4. 填写「导出时间范围」：列表已选时间范围时默认沿用，否则需要手动填写开始和结束时间。修改导出时间不影响列表筛选。
5. 设置「文件密码」，用于打开下载后的加密文件。请保存好密码，遗忘后只能重新导出。
6. 点击 **创建导出任务**。任务在后台排队生成，关闭窗口后继续处理。每个账号同一时间只能有一个处于「排队中」或「生成中」的任务，否则提示「已有导出任务正在处理或队列繁忙，请稍后重试」。
7. 任务状态变为「可下载」后，点击 **下载**，在「下载日志」中点击 **发送验证码**，输入发到绑定手机号的 6 位短信验证码，勾选「我已了解并会妥善保管敏感数据」，再点击 **验证并下载**。
8. 用创建任务时设置的密码打开下载的 ZIP 文件。

| 项目 | 限制 |
| --- | --- |
| 时间范围 | 单次最多 31 天；结束时间晚于当前时间时按当前时间截止 |
| 条数 | 单次最多 50,000 条，超出时任务标注「已达上限」 |
| 文件密码 | 6～128 个字符 |
| 文件格式 | AES-256 加密的 ZIP，内含 `ai-logs.csv` 或 `ai-logs.json`；系统自带的解压工具可能无法打开，可使用 7-Zip 等支持 AES 加密的工具 |
| 文件保留 | 创建任务后 24 小时，「剩余保留时间」显示倒计时，到期后文件删除、任务不再显示 |

导出内容包括元数据，以及已保存的提示词、对话、模型响应和四段报文体，不包括请求头和响应头。超过留存期或没有保存正文的日志只导出元数据，`content_state` 字段分别为 `expired` 和 `not_stored`，有正文时为 `stored`。

（截图：在日志导出中选择格式和时间范围，并设置文件密码。）

## 删除

- **导出文件**：创建 24 小时后从存储中删除，下载地址随之失效。
- **日志正文**：超过留存期后不再显示；关闭全文日志后，新请求不再保存正文。
- **日志记录**：保存 180 天后自动删除。
- **API Key**：删除 API Key 后，它已经产生的日志仍按上述期限保留。

控制台不提供手动删除单条日志的功能。需要删除个人信息或账户数据时，按[隐私政策](https://platform.lyrouter.com/ai_gateway/legal/privacy-policy)中的方式联系平台。

## 常见问题

### 导出能恢复没有保存或已过期的正文吗？

**答：** 不能。导出只包含导出时仍能查看的内容；没有开启全文日志时的请求，以及超过留存期的日志，只有元数据。需要长期留存正文时，请在留存期内定期导出。

### 弹窗提示「日志导出尚未启用，请联系管理员配置对象存储。」怎么办？

**答：** 当前部署没有配置导出文件的存储，无法创建导出任务。请联系平台管理员处理。

### 提示「单次最多导出 31 天，请调整导出时间范围。此修改不会影响列表。」怎么办？

**答：** 缩短「导出时间范围」，分多次导出。同一时间只能有一个任务在排队或生成，前一个任务变为「可下载」后再创建下一个。

### 下载时提示「请先在账号设置中绑定可用手机号」怎么办？

**答：** 下载验证码发送到创建任务的账号所绑定的手机号。请先在账号设置中绑定可用的手机号，再回到「最近导出任务」点击 **下载**。导出任务只有创建人可以下载，其他管理员需要自己创建任务。