查询调用日志与质量

使用服务端日志查找实际 API 请求，使用质量概览查看完整时间窗口的统计。客户端日志单独显示应用主动上报的诊断，不能代替服务端执行结果。

查询服务端日志

打开当前应用 → 开发接入 → 服务端日志。
选择最近七天内的起止时间，或使用最近 1、3、7 天快捷选项。
按请求 ID 或其他已知条件筛选，点击“查询”。

筛选项	说明
Request ID	精确查找一次请求
URL 路径、请求方法	使用公开路由模板，如 `/open-platform/v1/token-orders/{id}`，不要填写域名、查询参数或实际客户 ID
用户 OpenID	当前应用用户的 `open_id`；不能使用其他应用的用户标识
API Product、操作	对应已配置产品和操作
OAuth 配置 ID、调用身份	区分用户身份与应用身份的调用配置
调用结果、原因码、HTTP	按结构化结果筛选
错误信息	在固定错误说明中检索，忽略大小写；不查询请求正文

记录包含请求时间、Request ID、HTTP 状态、耗时和已采集的安全维度。URL 只显示路由模板；旧记录没有采集的字段显示为未知，不根据当前配置补填。查询只包含当前有权访问的应用和环境。

日志表最多显示前 100 条匹配记录，不能用表格行数估算完整调用量。没有记录不表示所有请求成功；检查查询窗口、筛选条件和实际采集状态。

查看质量概览

打开“开发接入 → 质量概览”，使用相同的时间和筛选条件查看调用次数、成功率、错误数、P95 延迟及操作统计。统计覆盖完整查询窗口，不从当前展示的日志行计算。

日志与统计可能分别暂不可用。页面会说明失败项，保留仍可读取的结果；点击重新读取恢复。统计不可用不会显示为零或成功，客户端上报也不计作可信服务端成功证明。

查询客户端日志

打开“开发接入 → 客户端日志”，按 Request ID、操作、原因码及最近 24 小时、3 天、7 天查询。记录保留七天，并标记为客户端上报。

没有匹配记录时，页面显示空列表，并提供“查看日志接入文档”入口。功能暂不可用与没有访问权限会分别提示；登录过期时，页面清除旧日志并提供“重新登录”，完成登录后继续查看当前应用。功能暂不可用时可联系平台支持，恢复后点击“刷新日志”。

客户端上报由你的应用主动执行，平台不会自动安装 SDK 或采集浏览器请求。使用当前应用用户的 OAuth Bearer 调用 POST /open-platform/v1/client-diagnostics，并携带独立的 Idempotency-Key。

json

{
  "request_id": "client-request-example-001",
  "operation": "load_catalog",
  "reason_code": "succeeded",
  "status_code": 200,
  "duration_ms": 120
}

名称	类型	必填	说明
`request_id`	string	🔴 必填	非敏感请求标识，1～100 字符；符合 `^[A-Za-z0-9][A-Za-z0-9._:/-]*$`
`operation`	string	🔴 必填	固定操作，符合 `^[a-z][a-z0-9_.-]{0,79}$`；不填正文或 URL
`reason_code`	string	🔴 必填	下列固定原因码之一
`status_code`	integer	🔴 必填	`0`～`599`；无响应时为 `0`
`duration_ms`	integer	🔴 必填	`0`～`86400000` 毫秒

原因码：succeeded、network_error、timeout、cancelled、validation_error、authorization_denied、rate_limited、upstream_error、client_error、unknown。请求只接受上表五个字段；应用和环境由当前用户身份解析，不额外填写。

将上面的合成记录保存为 client-diagnostic.json，使用当前环境提供的该接口完整地址和当前应用用户 Token。为这条记录生成一个独立的 GOODVISION_DIAGNOSTIC_KEY；恢复时保留该键与文件内容。

bash

curl --request POST \
  --url "${GOODVISION_CLIENT_DIAGNOSTICS_ENDPOINT}" \
  --header "authorization: Bearer ${GOODVISION_ACCESS_TOKEN}" \
  --header 'content-type: application/json' \
  --header "Idempotency-Key: ${GOODVISION_DIAGNOSTIC_KEY}" \
  --data-binary @client-diagnostic.json

每用户每应用最多 60 条／分钟。新建成功返回 201，相同键及相同内容恢复返回 200，不同内容复用原键返回 409。401／403 时停止上报并处理当前认证或资格；429 时退避；结果未知时保留原内容和键重试。

关联技术反馈

拥有当前应用支持权限时，可在服务端日志、客户端日志或最近七天的 Webhook 投递记录中选择“转为技术反馈”。该动作只准备日志引用；填写并明确提交后才创建工单。

平台核对引用所属应用和时间，保留必要诊断摘要，不复制请求正文。工单正文按需独立读取，收起或切换上下文后清除。向平台客服求助还需显式转交，不会自动公开应用内反馈。

日志、客户端上报和工单均不得包含 Token、Secret、Cookie、敏感请求头、客户正文或完整 URL。

查询调用日志与质量 ​

查询服务端日志 ​

查看质量概览 ​

查询客户端日志 ​

关联技术反馈 ​

查询调用日志与质量

查询服务端日志

查看质量概览

查询客户端日志

关联技术反馈