查看请求日志
功能概述
请求日志页面集中展示您账号下所有 API 请求的详细记录,帮助您:
- 追踪每一次 API 调用的状态和结果
- 分析请求的 Token 消耗和延迟
- 按多种维度筛选和定位特定请求
- 查看请求的详细信息(请求参数、响应内容、错误信息)
- 通过请求追踪时间线分析调用的各阶段耗时
请求日志是排查 API 调用问题、优化用量和监控系统健康状态的重要工具。
操作步骤
进入请求日志页面
在左侧导航栏中,点击 安全 分组下的 请求日志 菜单。
进入请求日志页面,默认展示最近的请求记录。
筛选请求日志
页面顶部提供多种筛选条件,帮助您快速定位目标请求:
按应用筛选
点击 应用 下拉菜单,选择一个或多个应用。
列表仅展示所选应用下的请求记录。
按 API Key 筛选
点击 API Key 下拉菜单,选择特定的 API Key。
按能力类型筛选
点击 能力类型 下拉菜单,选择一个或多个能力类型:
能力类型 说明 文本生成 Chat Completion 请求 图像生成 Image Generation 请求 向量嵌入 Embedding 请求 语音合成 TTS 请求 语音识别 STT 请求 Web 搜索 Web Search 请求
按请求 ID 查询
在 请求 ID 输入框中输入完整的请求 ID 进行精确查询。
按时间范围筛选
点击 日期范围 选择器,选择起止日期。
也可以选择预设的时间范围(今日、近 7 天、近 30 天)。
按来源筛选
点击 来源 下拉菜单,选择请求的来源渠道:
来源 说明 OpenAPI 通过 API 接口直接调用 Playground 通过控制台 Playground 发起 SDK 通过官方或第三方 SDK 发起
组合筛选与重置
多个筛选条件可以组合使用,列表将展示同时满足所有条件的记录。
点击 重置 按钮可清除所有筛选条件,恢复默认展示。
查看日志列表
请求日志以表格形式展示,包含以下列:
| 列名 | 说明 |
|---|---|
| 请求 ID | 唯一请求标识,可点击查看详情 |
| 请求时间 | 请求发起的时间 |
| 能力类型 | 该请求调用的 API 能力类型 |
| 状态 | 请求执行状态(成功/失败) |
| 输入 Token | 请求消耗的输入 Token 数 |
| 输出 Token | 请求消耗的输出 Token 数 |
| 延迟 | 请求从发出到收到响应的总耗时 |
| 客户端 IP | 发起请求的客户端 IP 地址 |
表格支持分页浏览,您可以通过底部分页控件切换页码或调整每页展示的条数。
查看请求详情
在日志列表中,点击某条记录的 请求 ID 链接或操作列的 查看详情 按钮。
页面右侧弹出详情抽屉,展示该请求的完整信息。
详情抽屉包含以下信息板块:
基本信息
- 请求 ID
- 请求时间
- 所属应用
- 使用的 API Key(前缀)
- 调用的模型
- 能力类型
- 请求来源
- 客户端 IP
请求参数
展示本次请求发送的完整参数,包括模型、消息内容、温度设置等。
响应结果
展示请求的响应内容,包括生成的文本、Token 用量等。
错误信息(仅失败的请求)
如果请求失败,将展示错误码、错误消息和可能的错误原因。
查看请求追踪时间线
在请求详情抽屉中,切换至 请求追踪 标签页。
请求追踪以时间线(Timeline)形式展示该请求的完整处理链路。
时间线由多个 Span(处理阶段)组成,每个 Span 包含以下信息:
字段 说明 阶段名称 处理步骤的名称(如「请求接收」「参数校验」「模型推理」「响应组装」) 持续时长 该阶段的耗时(毫秒) 执行状态 成功或失败 错误信息 如果该阶段失败,展示具体的错误描述 通过时间线,您可以直观地分析请求在各阶段的耗时分布,快速定位性能瓶颈或错误发生的环节。
导出日志
在日志列表页面,点击右上角的 导出 按钮。
选择导出的时间范围和格式,点击确认。
系统将生成导出文件并开始下载。
注意事项
- 请求日志默认保留近 30 天的记录。如需更早的日志,请联系平台客服获取。
- 日志数据存在短暂的写入延迟(通常不超过 1 分钟),如果刚发起的请求未出现在列表中,请稍等片刻后刷新。
- 请求 ID 是排查问题时的重要标识,向客服反馈问题时请提供对应的请求 ID。
- 请求追踪时间线中的耗时数据可帮助您区分网络延迟和模型推理时间,便于优化调用策略。
- 导出的日志文件包含敏感信息(如请求内容、客户端 IP),请妥善保管,避免泄露。
- 当日志量较大时,建议通过筛选条件缩小范围,以提升加载速度和查询效率。
相关文档
- 发起 API 调用 - 使用 API Key 调用接口的完整指南
- 管理 API Key - 创建和配置 API Key
- 应用详情与管理 - 在应用维度查看请求日志
- 控制台概览 - 了解控制台的整体布局