使用日志

使用日志页面提供了完整的 API 请求历史记录查询功能，让管理员和用户能够追踪、分析和排查所有通过 Claude Code Hub 的请求。

功能概述

使用日志记录了每一次 API 请求的详细信息，包括：

• 请求元数据：时间、用户、API Key、供应商、模型
• Token 统计：输入 Token、输出 Token、缓存 Token
• 成本信息：请求费用（支持多货币显示）
• 性能数据：请求耗时
• 状态信息：HTTP 状态码、错误详情、供应商决策链

页面布局

统计卡片

页面顶部显示四个统计卡片，汇总当前筛选条件下的数据：

筛选器

筛选器区域支持多维度组合查询：

数据导出

筛选器区域右侧提供「导出 CSV」按钮，可将当前筛选条件下的日志导出为 CSV 文件。

导出权限

CSV 文件内容

导出的 CSV 文件包含以下列：

日志表格

表格展示每条请求的详细信息，共 12 列：

计费详情

鼠标悬停在「成本」列时，会显示详细的计费明细 Tooltip，包括：

自动刷新

页面默认启用自动刷新功能：

• 刷新间隔：每 3 秒自动获取最新数据
• 新增高亮：新增的日志记录会短暂高亮显示（800ms 动画）
• 手动刷新：点击刷新按钮可立即获取最新数据
• 暂停刷新：可通过开关暂停自动刷新

供应商决策链

当请求经历了故障转移或重试时，「供应商」列会显示完整的决策链信息。

单次请求成功

直接显示供应商名称。如果供应商配置了成本倍率（costMultiplier），会显示对应的倍率标签：

• 橙色标签：倍率 > 1.0（成本增加）
• 绿色标签：倍率 < 1.0（成本降低）

多次请求（故障转移）

显示供应商链路，点击可查看详细的决策过程：

Provider1(✗) → Provider2(✗) → Provider3(✓)

决策链记录包括：

• 会话复用判断
• 首次供应商选择逻辑
• 请求失败原因
• 重试选择过程
• 最终成功/失败状态
• 错误规则匹配详情

错误详情弹窗

点击「状态」列的状态码，可打开详情弹窗查看完整信息。

状态码颜色

弹窗内容

1. 拦截信息（如果被拦截）

   • 拦截类型：sensitive_word（敏感词）
   • 拦截原因：匹配的敏感词、匹配类型

2. Session 信息

   • Session ID
   • 「查看详情」按钮：跳转到 Session 消息详情页

3. 请求信息

   • Messages 数量
   • User-Agent
   • Endpoint

4. 模型重定向（如果发生重定向）

   • 原始模型 → 重定向后模型
   • 计费模型标注

5. 错误消息

   • 格式化的错误详情
   • 限流错误特殊样式
   • 被过滤的供应商列表

6. 供应商决策链时间线

   • 完整的请求处理过程
   • 每个步骤的时间戳 [0000ms]
   • 供应商选择逻辑
   • 熔断器状态
   • 错误详情

时间线示例

[0000ms] 开始处理请求
[0005ms] 检查会话绑定：无已绑定供应商
[0010ms] 首次选择供应商
         - 选择方式：加权随机
         - 候选池大小：3
         - 选中：Provider-A (权重: 50, 优先级: 1)
[0015ms] 向 Provider-A 发起请求
[1234ms] Provider-A 请求失败
         - 状态码：429
         - 错误：Rate limit exceeded
[1240ms] 触发故障转移，重新选择供应商
         - 排除：Provider-A
         - 选中：Provider-B (权重: 30, 优先级: 1)
[1245ms] 向 Provider-B 发起请求
[2500ms] Provider-B 请求成功
         - 状态码：200
---
总耗时：2500ms

错误请求详情

当请求发生错误时（供应商错误、系统错误、HTTP/2 协议回退等），时间线中会显示该次请求的详细信息，便于问题排查。

可查看的信息

敏感信息脱敏

为保护安全，请求详情中的敏感信息会自动脱敏处理：

请求头脱敏

以下请求头的值会被部分遮罩：

• Authorization：保留认证类型前缀（如 Bearer），令牌只显示前后各 4 字符
• X-API-Key、API-Key、Anthropic-API-Key 等 API 密钥头
• Cookie、Set-Cookie
• Proxy-Authorization、X-Auth-Token 等认证相关头部

遮罩示例：

• Bearer sk-ant-api...****...xyz123 - 长令牌部分遮罩
• [REDACTED] - 短于 8 字符的值完全遮罩
• Basic [REDACTED] - Basic 认证完全遮罩（包含用户名密码）

URL 参数脱敏

以下 URL 查询参数的值会被替换为 [REDACTED]：

• api_key、api-key、apiKey、key
• token、access_token、auth_token
• secret、client_secret、password

请求体截断

• 请求体最大显示 2000 字符
• 超出部分会被截断，并标注「已截断」提示
• 在时间线详情展示时进一步限制为 500 字符预览

特殊标记

非计费端点

某些端点（如 /v1/messages/count_tokens）不产生费用，这类请求在表格中以置灰背景显示。

被拦截请求

被敏感词过滤等规则拦截的请求，供应商列显示橙色「已拦截」标记。

模型重定向

当模型发生重定向时，可点击模型名称旁的箭头图标查看重定向详情：

• 原始请求模型
• 实际使用模型
• 计费依据模型（根据 billingModelSource 配置）

相关配置

以下系统设置影响日志显示：

使用场景

费用审计

通过时间范围和用户筛选，查看特定时段或用户的 API 使用费用。

问题排查

当用户反馈请求异常时，可通过以下方式定位问题：

1. 按用户和时间筛选相关请求
2. 查看状态码和错误详情
3. 分析供应商决策链，了解故障转移过程
4. 跳转到 Session 详情查看完整请求内容

性能分析

通过耗时列和供应商决策链，分析请求的性能瓶颈：

• 单次请求耗时
• 故障转移带来的额外延迟
• 不同供应商的响应速度对比

供应商监控

结合供应商筛选和状态码筛选，监控特定供应商的服务质量：

• 错误率统计
• 常见错误类型
• 故障转移频率

下一步

• 活跃 Session - 查看当前正在进行的会话
• 排行榜 - 查看用户使用排名
• 日志设置 - 配置日志保留策略