# 查询与排查请求日志

从调用记录定位一次请求，检查调用结果和上游请求尝试，并在正文完成归档后下载完整请求或响应。

## 前提条件

准备个人访问令牌，以及需要排查的时间范围、模型或调用凭据信息。有关认证和查询范围，请参阅[使用与监测](../../../../reference/api/genesis/management/index.md)。

## 调用顺序

1. 查询请求日志列表，按时间和调用信息定位目标记录，取得该记录的日志标识。
2. 使用日志标识查询详情，检查调用结果、正文预览及归档信息。
3. 需要检查上游处理情况时，使用同一日志标识查询上游请求记录，逐次查看尝试结果。
4. 需要完整正文时，先在详情中确认所需正文已完成归档，再使用同一日志的正文归档引用下载请求或响应正文。

## API 操作

| 要完成的事 | API 操作 | 何时使用或确认什么 |
| --- | --- | --- |
| 定位目标调用 | [查询请求日志列表](../../../../reference/api/genesis/management/request-logs/list-request-logs.md) | 按筛选条件浏览调用并取得日志标识。 |
| 查看调用详情 | [查询请求日志详情](../../../../reference/api/genesis/management/request-logs/get-request-log.md) | 查看调用结果、正文预览及归档信息。 |
| 检查上游尝试 | [查询上游请求记录](../../../../reference/api/genesis/management/request-logs/list-provider-requests.md) | 查看该次调用向上游发出的各次请求及结果。 |
| 获取完整正文 | [下载请求或响应正文](../../../../reference/api/genesis/management/request-logs/download-body.md) | 所需正文已完成归档且已取得对应引用时使用。 |

## 结果确认

通过[查询请求日志详情](../../../../reference/api/genesis/management/request-logs/get-request-log.md)确认目标调用。检查上游记录是否属于该日志；下载后，可根据详情中的正文大小和校验信息核对完整性。

## 限制和注意事项

- 查询只返回当前用户有权访问的记录。
- 正文预览不等于完整正文，日志存在也不代表正文已经完成归档。
- 下载使用的日志标识与正文引用必须属于同一条日志。下载结果是原始字节，不是 JSON 响应包络。
- 请求和响应正文可能包含业务数据，保存和分享前确认访问范围，避免泄露敏感内容。

## 下一步

- [分析调用用量](usage.md)
- [查询模型目录与运行状态](models-and-status.md)