开发者中心的请求日志选项卡显示贵组织的 /v1 API 流量:在可搜索的单个请求日志上方,提供过去 24 小时的汇总统计信息,包括请求数、错误率和受速率限制的请求数。
每个条目记录的内容
日志表显示每次调用的时间、HTTP 方法、路径、响应状态、策略决策、延迟和请求 ID。打开某个条目即可查看完整详情,包括发起调用的服务账号和 API 密钥、来源 IP,以及当时生效的权限。
策略决策说明了请求的处理方式:
- 已允许 — 请求已通过身份验证和授权。
- 已拒绝 — 请求被拒绝,例如密钥缺少所需权限、已过期或已被撤销。
- 受速率限制 — 请求超出请求配额,并被拒绝,返回
429。请参阅速率限制。
筛选和搜索
可按服务账号、API 密钥、HTTP 方法、状态类别(2xx–5xx)、策略决策、时间范围或路径前缀(例如 /v1/entities)缩小日志范围。
通过请求 ID 跟踪错误
每个 API 响应都包含 Request-Id 标头,每个错误响应正文的 request_id 字段中也包含相同的值。将该值粘贴到请求日志搜索框中,即可直接跳转到匹配的条目,并准确了解该请求的处理方式。
当某个集成报告错误时,请索取错误响应中的 request_id。从客户端出现的症状追溯到实际发生情况的权威记录,这是最快捷的途径;如果您联系 Living Security 支持团队,也应提供该值。
及早发现问题
- 错误率上升通常意味着某个密钥已过期、被撤销或失去了所需的权限,可按决策筛选以找出失败的凭据。
- 受速率限制的数量上升意味着某个工作负载的请求过于密集;有关平滑请求的策略,请参阅速率限制。
- 如果本应处于空闲状态的服务账号出现流量,则表明需要检查其凭据是否仍在您预期的位置,并在调查期间禁用该账号。