Skip to content

查看请求日志 ​

功能概述 ​

请求日志页面集中展示您账号下所有 API 请求的详细记录,帮助您:

  • 追踪每一次 API 调用的状态和结果
  • 分析请求的 Token 消耗和延迟
  • 按多种维度筛选和定位特定请求
  • 查看请求的详细信息(请求参数、响应内容、错误信息)
  • 通过请求追踪时间线分析调用的各阶段耗时

请求日志是排查 API 调用问题、优化用量和监控系统健康状态的重要工具。

操作步骤 ​

进入请求日志页面 ​

  1. 在左侧导航栏中,点击 安全 分组下的 请求日志 菜单。

    进入请求日志

  2. 进入请求日志页面,默认展示最近的请求记录。

    请求日志页面

筛选请求日志 ​

页面顶部提供多种筛选条件,帮助您快速定位目标请求:

按应用筛选

  1. 点击 应用 下拉菜单,选择一个或多个应用。

    按应用筛选

  2. 列表仅展示所选应用下的请求记录。

    应用筛选结果

按 API Key 筛选

  1. 点击 API Key 下拉菜单,选择特定的 API Key。

    按API Key筛选

按能力类型筛选

  1. 点击 能力类型 下拉菜单,选择一个或多个能力类型:

    能力类型说明
    文本生成Chat Completion 请求
    图像生成Image Generation 请求
    向量嵌入Embedding 请求
    语音合成TTS 请求
    语音识别STT 请求
    Web 搜索Web Search 请求

    按能力类型筛选

按请求 ID 查询

  1. 在 请求 ID 输入框中输入完整的请求 ID 进行精确查询。

    按请求ID查询

按时间范围筛选

  1. 点击 日期范围 选择器,选择起止日期。

    选择日期范围

  2. 也可以选择预设的时间范围(今日、近 7 天、近 30 天)。

    预设时间范围

按来源筛选

  1. 点击 来源 下拉菜单,选择请求的来源渠道:

    来源说明
    OpenAPI通过 API 接口直接调用
    Playground通过控制台 Playground 发起
    SDK通过官方或第三方 SDK 发起

    按来源筛选

组合筛选与重置

  • 多个筛选条件可以组合使用,列表将展示同时满足所有条件的记录。

  • 点击 重置 按钮可清除所有筛选条件,恢复默认展示。

    重置筛选条件

查看日志列表 ​

请求日志以表格形式展示,包含以下列:

列名说明
请求 ID唯一请求标识,可点击查看详情
请求时间请求发起的时间
能力类型该请求调用的 API 能力类型
状态请求执行状态(成功/失败)
输入 Token请求消耗的输入 Token 数
输出 Token请求消耗的输出 Token 数
延迟请求从发出到收到响应的总耗时
客户端 IP发起请求的客户端 IP 地址

请求日志表格

表格支持分页浏览,您可以通过底部分页控件切换页码或调整每页展示的条数。

分页控件

查看请求详情 ​

  1. 在日志列表中,点击某条记录的 请求 ID 链接或操作列的 查看详情 按钮。

    点击查看详情

  2. 页面右侧弹出详情抽屉,展示该请求的完整信息。

    详情抽屉

  3. 详情抽屉包含以下信息板块:

    基本信息

    • 请求 ID
    • 请求时间
    • 所属应用
    • 使用的 API Key(前缀)
    • 调用的模型
    • 能力类型
    • 请求来源
    • 客户端 IP

    请求基本信息

    请求参数

    展示本次请求发送的完整参数,包括模型、消息内容、温度设置等。

    请求参数

    响应结果

    展示请求的响应内容,包括生成的文本、Token 用量等。

    响应结果

    错误信息(仅失败的请求)

    如果请求失败,将展示错误码、错误消息和可能的错误原因。

    错误信息

查看请求追踪时间线 ​

  1. 在请求详情抽屉中,切换至 请求追踪 标签页。

    切换到请求追踪

  2. 请求追踪以时间线(Timeline)形式展示该请求的完整处理链路。

    请求追踪时间线

  3. 时间线由多个 Span(处理阶段)组成,每个 Span 包含以下信息:

    字段说明
    阶段名称处理步骤的名称(如「请求接收」「参数校验」「模型推理」「响应组装」)
    持续时长该阶段的耗时(毫秒)
    执行状态成功或失败
    错误信息如果该阶段失败,展示具体的错误描述

    Span详情

  4. 通过时间线,您可以直观地分析请求在各阶段的耗时分布,快速定位性能瓶颈或错误发生的环节。

    时间线分析

导出日志 ​

  1. 在日志列表页面,点击右上角的 导出 按钮。

    点击导出按钮

  2. 选择导出的时间范围和格式,点击确认。

    选择导出范围

  3. 系统将生成导出文件并开始下载。

    下载导出文件

注意事项 ​

  • 请求日志默认保留近 30 天的记录。如需更早的日志,请联系平台客服获取。
  • 日志数据存在短暂的写入延迟(通常不超过 1 分钟),如果刚发起的请求未出现在列表中,请稍等片刻后刷新。
  • 请求 ID 是排查问题时的重要标识,向客服反馈问题时请提供对应的请求 ID。
  • 请求追踪时间线中的耗时数据可帮助您区分网络延迟和模型推理时间,便于优化调用策略。
  • 导出的日志文件包含敏感信息(如请求内容、客户端 IP),请妥善保管,避免泄露。
  • 当日志量较大时,建议通过筛选条件缩小范围,以提升加载速度和查询效率。

相关文档 ​