日志内容与数据处理

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

日志保存哪些内容

内容 全文日志关闭 全文日志开启
元数据:时间、API Key、API 路径、模型、服务商、状态码与状态说明、Token、费用、耗时、客户端、采样参数、请求中定义的工具名称、路由追踪、安全审查命中记录 保存 保存
四段报文的请求头和响应头(凭据类请求头除外) 保存 保存
提示词、对话、回答和思考过程 不保存 保存(脱敏后)
模型返回的工具调用(函数名与参数) 保存 保存
四段报文的报文体 不保存 保存(脱敏后)
失败请求的上游错误响应、返回给客户端的错误响应 保存(脱敏后,每段最多 64 KB) 保存(脱敏后)
  • 开启后每段正文最多保存 1 MB,超出部分截断。
  • Authorization、x-api-key、api-key、Cookie、Proxy-Authorization 等凭据类请求头在任何情况下都不保存。
  • 安全围栏命中时,安全事件会保存触发位置附近的一小段脱敏文本作为证据,这与全文日志开关无关。

开启或关闭全文日志

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

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

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

图 1:在日志详情存储策略中开启保存请求响应全文,并确认五项信息处理告知。 截图为演示数据,点击图片可查看原图。

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

平台脱敏

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

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

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

上游服务商会收到什么

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

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

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

平台对个人信息的处理规则见隐私政策。

谁能查看正文和导出日志

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

导出文件包含已保存的提示词、对话、模型响应和报文体,因此下载前需要验证绑定手机号并确认妥善保管,完整步骤见数据保留、导出与删除。

日志导出按时间范围和格式生成加密文件,需要设置文件密码。

图 2:日志导出按时间范围和格式生成加密文件,需要设置文件密码。 截图为演示数据,点击图片可查看原图。

常见问题

开启全文日志后,能看到之前请求的正文吗?

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

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

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

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

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