# 请求日志 — 保存并查看每次请求的输入与输出

Source: https://ofox.ai/zh/docs/develop/observability/request-logs

OfoxAI 默认零数据留存（ZDR），不保存请求内容。排查问题时，团队可以开启「日志保留」，在控制台逐条查看每次请求的完整输入和输出。

请求日志默认关闭。没有开启的团队，请求内容不会被保存，开启之前的请求也无法补看。

## 能看到什么

开启后，新请求会保存输入、输出、工具调用和出错原因。请求和响应里的图片需要单独勾选「同时保存图片」才会保存。

在 **请求明细** 里，有日志的请求会带标记，点开就能按时间线查看这次请求的每一步，以及耗时、Token、费用等概要。

## 开启日志保留

只有团队所有者和管理员可以开启。

1. 打开 [控制台](https://app.ofox.ai) 的 **请求明细**
2. 点右上角 **日志保留**
3. 点 **开启日志保留**
4. 在「保存哪些请求」里选择范围：
   - **所有 API Key**：可以排除个别 Key
   - **指定的 API Key**：只保存列出的 Key
5. 按需勾选「同时保存图片」

设置只对之后的新请求生效。

## 保存上限

| 项目 | 上限 |
|------|------|
| 保存时长 | 最近 3 天 |
| 保留条数 | 最近 1 万条 |
| 存储空间 | 1 GB |

任一项到上限时，自动清除最旧的日志。需要保存更久，发邮件到 [hi@ofox.ai](mailto:hi@ofox.ai) 告诉我们。

## 敏感信息处理

保存前，API Key、令牌、密码、Cookie、私钥和带签名的链接参数会替换为 `[REDACTED]`。

手机号、邮箱等个人信息不会被处理。如果请求里包含用户的个人数据，请在开启前评估，或用下面的请求头跳过保存。

## 单次请求不保存

在请求里加上请求头即可跳过这一次的保存：

```http
X-OfoxAI-Log-Content: off
```

```python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.ofox.ai/v1",
    api_key="<你的 OFOXAI_API_KEY>",
)

response = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "这条请求不保存日志"}],
    extra_headers={"X-OfoxAI-Log-Content": "off"},
)
```

## 谁能查看

| 操作 | 团队所有者 / 管理员 | 普通成员 |
|------|------|------|
| 开启、关闭、调整范围 | ✅ | ❌ |
| 查看日志内容 | ✅ | ❌ |
| 删除日志 | ✅ | ❌ |

普通成员需要查看某次请求的完整内容时，请联系团队管理员。

## 删除与关闭

- **删除单条日志**：在请求详情里删除。
- **按时间段删除**：在日志保留设置里点「删除已保存的日志」，可以选最近 1 小时、今天、全部或自定义时间段。删除后无法恢复，调用记录、Token 用量和费用不受影响。
- **关闭日志保留**：关闭后新请求不再保存。已保存的日志不会立即删除，会在保存期满后自动清除；需要立即删除，请用上面的删除功能。

## 常见问题

**为什么某条请求点开显示「没有保存日志」？**

可能是：请求发生在开启之前；所属的 API Key 不在保存范围内；请求带了 `X-OfoxAI-Log-Content: off`；或者日志已过期、已被删除。

**开启日志会额外收费吗？**

不会。日志保留不额外收费，调用记录、Token 用量和计费方式不变。

**和零数据留存（ZDR）是什么关系？**

没有开启日志保留的团队仍是零数据留存。开启后，保存范围内的请求内容按上面的上限保存。详见 [安全与数据](https://ofox.ai/zh/docs/develop/security)。