排查调用日志
什么时候用
Agent 调用 MCP 工具出现问题时（如工具调用失败、超时、返回异常等），通过查看调用日志来定位问题原因。
你需要准备
- 已发生的 MCP 工具调用（日志会自动记录）
- 如需筛选，准备相关信息（如 Server ID、Agent ID、工具名等）
操作步骤
第 1 步：进入调用日志页
左侧菜单 → MCP 网关 → 调用日志。
页面默认展示最近的调用记录。点击右上角「刷新」按钮可获取最新日志。
第 2 步：设置筛选条件（可选）
页面顶部提供多个筛选条件，帮助快速定位问题：
| 筛选条件 | 怎么用 | 说明 |
|---|---|---|
| MCP Server | 输入 Server ID | 只查看该 Server 的调用记录 |
| 工具名 | 输入工具名关键词 | 按工具名模糊筛选 |
| 状态 | 下拉选择状态 | 只查看指定状态的调用（成功/拒绝/上游错误/超时/限流） |
| Agent ID | 输入 Agent ID | 只查看该 Agent 的调用记录 |
| 开始时间 / 结束时间 | 选择时间范围 | 只查看该时间段内的调用记录 |
设置完筛选条件后，点击「查询」按钮刷新结果；点击「重置」按钮清空所有筛选条件。
第 3 步：查看日志列表
日志列表展示以下信息：
| 列 | 说明 |
|---|---|
| ID | 日志唯一标识 |
| Trace ID | 链路追踪 ID（悬停查看完整值） |
| Agent ID | 触发调用的 Agent ID |
| 工具名 | 被调用的工具名 |
| 状态 | 调用结果状态（成功/拒绝/上游错误/超时/限流） |
| 拒绝原因 | 若状态为拒绝，显示拒绝原因（悬停查看完整值） |
| 耗时 | 调用耗时（毫秒） |
| 时间 | 调用发生时间 |
第 4 步：展开查看详情
点击日志行左侧的展开箭头，查看该次调用的详细信息：
- 调用参数 (args)：传递给工具的参数（JSON 格式）
- 调用结果 (result)：工具返回的结果（JSON 格式）
怎么验证成功了
- 能在日志列表中看到调用记录
- 筛选功能正常工作
- 展开日志能看到完整的调用参数和结果
- 状态和拒绝原因清晰展示
常见问题
调用状态是「超时」怎么办
- 检查上游 MCP Server 是否正常响应
- 确认网络连接是否稳定
- 查看上游服务是否有性能问题
- 考虑增加超时时间（如需调整请联系平台管理员）
「上游错误」和「拒绝」有什么区别
- 上游错误：请求已发送到上游 Server，但 Server 返回错误
- 拒绝：请求在平台侧被拒绝（如 Server 不存在、未启用、无权限等），未发送到上游
拒绝时可查看「拒绝原因」列获取详细信息。
调用参数和结果是脱敏的吗
是的，敏感信息会被脱敏处理。如需查看完整信息，请联系平台管理员。
日志保留多长时间
日志保留时间取决于平台配置，通常保留 30 天。如需更长时间的日志，请联系平台管理员。
怎么通过 Trace ID 关联其他日志
Trace ID 可用于在其他日志系统（如应用日志、审计日志）中关联同一次请求的完整链路。复制完整 Trace ID 后在相应系统中搜索即可。
看不到最新的调用记录
- 点击右上角「刷新」按钮
- 检查筛选条件是否过于严格
- 确认调用确实已发生（可能有短暂延迟）
深入
核心概念
调用日志
每次 tools/call 会写 MCP 调用日志。
包含 trace_id、agent_id、mcp_server_id、user_id、api_key_id、tool_name、args、result、status、deny_reason、latency_ms。
权限边界
| 操作 | 租户 admin | 平台管理员 |
|---|---|---|
| 查看本租户调用日志 | 可以 | 可以 |
| 查看其它租户资源 | 不可以 | 可按平台权限处理 |
- 注册 MCP Server：注册上游 MCP Server
- 查看绑定关系：同步工具与查看权限