概述

日志分析集成百度智能云日志服务（BLS）实现网关访问日志的采集与检索，用于问题排查与审计。开启日志采集后可直接在网关控制台内查询日志，无需跳转到 BLS。入口位于实例导航的 观测与分析 > 日志分析。

说明：日志存储与检索按 BLS 产品计费，具体参考费用详情。

开启日志采集

1. 登录 API 网关专享版控制台，在左侧导航选择目标实例。
2. 进入 观测与分析 > 日志分析，单击开启日志采集。
3. 选择日志组与日志集（可在创建实例时的「日志配置」步骤预先配置）。

日志配置也可在实例详情的「关联服务设置」中查看与编辑，包含开启状态、日志组与日志集。

检索日志

开启后页面内嵌 BLS 日志查询面板，当前使用的日志组与日志集展示在面板顶部，支持以下能力：

访问日志字段

网关投递的访问日志包含以下字段：

ai_log 字段

ai_log 为 JSON 结构，包含以下子字段：

常用查询示例

说明：以下示例用于展示查询思路，请根据实际的日志集索引配置调整字段与语法。 按 API 维度查询访问日志

1route_name: "{API 名称}"

排查指定请求

1request_id: "{x-request-id}"

查询 5xx 错误请求

1response_code >= 500

查询某个模型的调用记录

1ai_log.model: "{模型名称}"

统计各模型的 Token 消耗

1* | select ai_log.model, sum(ai_log.input_token) as input_tokens, sum(ai_log.output_token) as output_tokens group by ai_log.model

查询指定消费者的调用明细

1ai_log.consumer: "{消费者名称}"

关闭日志采集

不再需要时可在页面内单击 关闭日志 关闭日志采集，关闭后网关不再向 BLS 投递访问日志。

注意：关闭采集不会删除 BLS 中已有的历史日志，历史日志的保留与清理遵循 BLS 日志集的配置。

使用建议

• 生产实例建议保持日志采集开启，便于事后追溯与审计。
• 网关默认不投递请求体与响应体内容，涉及请求内容的排查请结合业务侧日志。
• 结合业务监控与调用链分析形成「指标 → 链路 → 日志」的完整排查路径。