# 日志内容与数据处理

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

模型调用的内容经过 LYRouter 网关转发给选中的上游服务商。日志默认只记录元数据，例如模型、服务商、状态码、Token、费用和耗时；只有工作空间开启「保存请求响应全文」后，才会保存经过平台脱敏的提示词、回答和报文正文。本章说明日志保存哪些内容、如何开关全文日志、上游服务商会收到什么，以及谁能查看正文和导出日志。

## 日志保存哪些内容

| 内容 | 全文日志关闭 | 全文日志开启 |
| --- | --- | --- |
| 元数据：时间、API Key、API 路径、模型、服务商、状态码与状态说明、Token、费用、耗时、客户端、采样参数、请求中定义的工具名称、路由追踪、安全审查命中记录 | 保存 | 保存 |
| 四段报文的请求头和响应头（凭据类请求头除外） | 保存 | 保存 |
| 提示词、对话、回答和思考过程 | 不保存 | 保存（脱敏后） |
| 模型返回的工具调用（函数名与参数） | 保存 | 保存 |
| 四段报文的报文体 | 不保存 | 保存（脱敏后） |
| 失败请求的上游错误响应、返回给客户端的错误响应 | 保存（脱敏后，每段最多 64 KB） | 保存（脱敏后） |

- 开启后每段正文最多保存 1 MB，超出部分截断。
- `Authorization`、`x-api-key`、`api-key`、`Cookie`、`Proxy-Authorization` 等凭据类请求头在任何情况下都不保存。
- 安全围栏命中时，[安全事件](https://platform.lyrouter.com/ai_gateway/docs/guardrails)会保存触发位置附近的一小段脱敏文本作为证据，这与全文日志开关无关。

## 开启或关闭全文日志

全文日志按工作空间设置，默认关闭。当前账号管理员和工作空间管理员可以修改；其他成员的 **日志存储设置** 按钮不可用，提示「仅管理员可修改全文日志设置。」

1. 在工作空间的 **日志分析** 页点击 **日志存储设置**，打开「日志详情存储策略」。
2. 打开「保存请求响应全文」开关，逐项勾选五项信息处理告知：
   - 「我知悉请求和响应内容会在平台脱敏后保存。」
   - 「我知悉内容的存储位置，并确认其处于配置的数据边界内。」
   - 「我知悉内容保留期限及删除流程。」
   - 「我知悉可访问内容的工作空间角色范围。」
   - 「我同意内容仅用于此处说明的调试、分析和安全取证。」
3. 点击 **保存**。没有全部勾选时，提示「请先确认全部信息处理告知事项。」

（截图：在日志详情存储策略中开启保存请求响应全文，并确认五项信息处理告知。）

- **当前状态**：工具栏的「全文日志」标签显示「已开启」或「已关闭」。显示「未获取到」时无法打开设置，稍后刷新页面再试。
- **只对新请求生效**：开启之前已经发生的调用不会补存正文，这些日志的详情显示「本条日志未记录正文」。
- **关闭后**：新的请求不再保存正文，已保存的内容仍按现有保留策略处理，保留期限见[数据保留、导出与删除](https://platform.lyrouter.com/ai_gateway/docs/retention)。
- **操作记录**：每次开启或关闭都会记录操作人、时间和勾选的告知事项。

## 平台脱敏

全文日志保存的正文和失败请求的错误响应，在保存前都会经过平台脱敏，有正文的日志详情标注「正文已按平台策略脱敏」。脱敏按固定规则识别：

- `Bearer` 令牌、以 `sk-` 开头的密钥，以及名为 `api_key`、`token`、`secret`、`password` 等字段的值；
- 手机号、身份证号、银行卡号等较长的数字串，只保留首尾几位；
- IP 地址替换为 `[ip]`，邮箱地址替换为 `[email]`；
- 图片等 base64 内容只保存长度和校验摘要，不保存原始数据。

规则无法覆盖所有敏感信息，例如姓名和地址不会被识别。处理高度敏感的数据时，请保持全文日志关闭。

## 上游服务商会收到什么

- **完成调用所需的内容**：消息、系统提示词、参数、工具定义，以及图片、音频等输入。网关可能为适配服务商转换协议或参数，日志「原始报文」的「② 上游请求」就是实际发给服务商的内容。
- **网关的凭证**：网关使用平台凭证或你的 BYOK 凭证调用服务商，你的 LYRouter API Key 不会转发给上游。
- **日志脱敏不改变发往上游的内容**。需要在发出前遮盖敏感信息时，在[安全围栏](https://platform.lyrouter.com/ai_gateway/docs/guardrails)中配置「敏感信息检测」策略，并选择「掩码」动作。

各服务商是否将提示词用于模型训练，在 **模型广场** 打开模型详情，在「服务商与价格」中查看服务商名称旁的盾牌图标，鼠标停留时显示：

| 提示 | 含义 |
| --- | --- |
| 「该服务商不会将提示词用于模型训练。」 | 服务商声明不用于训练 |
| 「请注意：该服务商可能将提示词用于模型训练。」 | 服务商可能用于训练 |
| 「该服务商尚未披露是否将提示词用于模型训练。」 | 没有可用的声明，不代表不会训练 |

平台对个人信息的处理规则见[隐私政策](https://platform.lyrouter.com/ai_gateway/legal/privacy-policy)。

## 谁能查看正文和导出日志

| 操作 | 当前账号管理员、工作空间管理员 | 普通成员 |
| --- | --- | --- |
| 查看日志 | 工作空间内所有 API Key 的日志 | 只有自己创建的 API Key 产生的日志 |
| 「对话」和「原始报文」四段报文 | 可以 | 可以（仅自己的 API Key） |
| 「路由追踪」、按每次尝试分组的上游报文 | 可以 | 不显示 |
| 导出日志 | 可以 | 不可以 |
| 修改全文日志设置 | 可以 | 不可以 |

导出文件包含已保存的提示词、对话、模型响应和报文体，因此下载前需要验证绑定手机号并确认妥善保管，完整步骤见[数据保留、导出与删除](https://platform.lyrouter.com/ai_gateway/docs/retention#加密导出)。

（截图：日志导出按时间范围和格式生成加密文件，需要设置文件密码。）

## 常见问题

### 开启全文日志后，能看到之前请求的正文吗？

**答：** 不能。全文日志只对开启之后的新请求生效，之前的日志只有元数据。

### 没有开启全文日志，为什么失败的请求能看到响应内容？

**答：** 失败请求的上游错误响应和返回给客户端的错误响应会单独保存（每段最多 64 KB，已脱敏），用于排查问题。提示词和成功请求的回答不会保存。

### 普通成员能看到其他人的对话吗？

**答：** 不能。普通成员只能查看自己创建的 API Key 产生的日志。当前账号管理员和工作空间管理员可以查看工作空间内所有 API Key 的日志正文，开启全文日志前请在团队内明确这一点。