跳到主要内容

访问日志

概述​

访问日志记录了所有通过 LLM Gateway 的 API 请求,提供完整的访问历史、使用统计和审计追踪。通过访问日志,您可以:

  • 查看所有 API 请求的详细记录
  • 分析使用模式和趋势
  • 追踪特定请求的执行过程
  • 审计用户和 Token 的使用情况
  • 排查错误和性能问题
  • 生成使用报告和账单
📋
完整记录
记录每个请求的详细信息和响应结果
🔍
高级筛选
按时间、用户、模型、状态等多维度筛选
🔎
实时搜索
快速搜索和定位特定请求
📥
数据导出
导出日志用于离线分析和归档

日志内容​

日志字段​

每条访问日志包含以下信息:

字段说明示例
时间戳请求时间2025-10-18 10:30:00
请求 ID唯一标识符req_abc123
用户请求用户user_001
Token使用的 API Tokensk-abc...xyz
IP 地址客户端 IP192.168.1.100
模型请求的模型gpt-4
渠道使用的渠道channel_001
路由策略路由策略balanced
输入 Tokens输入 token 数500
输出 Tokens输出 token 数734
总 Tokens总 token 数1234
响应时间耗时(秒)2.3
状态成功/失败success
错误信息错误详情-
成本估算成本$0.0456

日志级别​

  • INFO: 正常请求
  • WARNING: 警告(如配额接近上限)
  • ERROR: 请求失败
  • SECURITY: 安全事件(如异常访问)

日志示例​

{
  "id": "log_abc123",
  "timestamp": "2025-10-18T10:30:00Z",
  "request_id": "req_abc123",
  "user_id": "user_001",
  "username": "john_doe",
  "token_id": "token_001",
  "token_name": "生产环境主 Token",
  "ip_address": "192.168.1.100",
  "user_agent": "openai-python/1.0.0",
  "model": "gpt-4",
  "channel_id": 1,
  "channel_name": "OpenAI 官方",
  "routing_strategy": "balanced",
  "request": {
    "model": "gpt-4",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "max_tokens": 1000
  },
  "response": {
    "id": "chatcmpl-abc123",
    "model": "gpt-4",
    "choices": [
      {
        "message": {
          "role": "assistant",
          "content": "Hello! How can I help you today?"
        }
      }
    ],
    "usage": {
      "prompt_tokens": 8,
      "completion_tokens": 10,
      "total_tokens": 18
    }
  },
  "tokens": {
    "input": 8,
    "output": 10,
    "total": 18
  },
  "latency_ms": 2300,
  "status": "success",
  "http_status": 200,
  "error": null,
  "cost_usd": 0.00054,
  "cache_hit": false,
  "firewall_triggered": false
}

查看日志​

日志列表​

在访问日志页面查看所有请求记录:

访问日志列表

默认视图:

  • 时间倒序排列(最新在前)
  • 显示关键字段
  • 支持分页浏览

操作:

  • 点击行展开详情
  • 双击查看完整请求/响应
  • 右键菜单快捷操作

日志详情​

点击日志条目查看完整详情:

日志详情页面

详情包含:

  • 请求元数据
  • 完整请求内容
  • 完整响应内容
  • 执行时间线
  • 相关日志链接

日志筛选​

使用多维度筛选快速定位日志:

按时间范围筛选:

  • 最近 1 小时
  • 最近 24 小时
  • 最近 7 天
  • 最近 30 天
  • 自定义时间范围
时间筛选

日志搜索​

快速搜索特定内容:

req_abc123
日志搜索

日志分析​

统计概览​

查看日志的统计摘要:

日志统计概览

指标:

  • 总请求数
  • 成功率
  • 平均响应时间
  • 总 tokens 使用
  • 总成本
  • 错误分布

使用趋势​

查看使用趋势图表:

显示请求数随时间的变化:

  • 按小时聚合
  • 按天聚合
  • 按周聚合
请求量趋势图

分布分析​

分析使用分布:

按模型统计使用量:

  • 饼图显示占比
  • 表格显示详细数据
模型分布图

Top 分析​

👥
Top 用户
使用量最大的用户
🧠
Top 模型
最常使用的模型
⚠️
Top 错误
最常见的错误类型
🕒
慢请求
响应时间最长的请求

报告和导出​

生成报告​

生成各类使用报告:

1
选择报告类型
  • 日报
  • 周报
  • 月报
  • 自定义报告
2
选择时间范围
指定报告的时间范围。
3
选择维度

选择分析维度:

  • 按用户
  • 按模型
  • 按渠道
  • 综合报告
4
生成和下载

点击生成,下载 PDF/Excel 格式报告。

生成报告

导出日志​

导出日志数据:

导出为 CSV 格式:

  • 适合 Excel 分析
  • 自定义导出字段
  • 支持大数据量
CSV 导出

日志保留​

保留策略​

配置日志保留时间:

日志类型默认保留可配置范围
详细日志30 天7-90 天
统计数据1 年90 天-永久
错误日志90 天30 天-永久
审计日志永久1 年-永久

日志归档​

自动归档历史日志:

  • 定期压缩旧日志
  • 转移到冷存储
  • 支持按需恢复
日志归档设置

日志清理​

清理不需要的日志:

注意

日志清理是不可逆操作,请谨慎执行。

清理选项:

  • 按时间范围删除
  • 按条件删除
  • 保留错误日志
  • 保留审计日志

实时监控​

实时日志流​

实时查看新产生的日志:

实时日志流

功能:

  • 自动滚动
  • 高亮错误
  • 筛选器实时生效
  • 暂停/恢复

告警规则​

配置日志告警:

{
  "rule": "错误率过高",
  "condition": "error_rate > 5% in 5min",
  "action": "send_email",
  "recipients": ["admin@example.com"]
}

常见告警:

  • 错误率突增
  • 响应时间过长
  • 特定错误出现
  • 异常访问模式

审计追踪​

审计日志​

记录所有管理操作:

[2025-10-18 10:30:00] [AUDIT]
User: admin_user
Action: UPDATE_CHANNEL
Target: channel_001
Changes:
  - priority: 100 → 95
IP: 192.168.1.100

合规报告​

生成符合合规要求的审计报告:

  • GDPR 数据访问报告
  • SOC2 审计追踪
  • HIPAA 访问日志

常见问题​

日志可以保存多久?
  • 默认保留 30 天
  • 可配置最长永久保留
  • 建议定期归档
如何查找特定请求?

使用请求 ID 搜索:

  1. 复制请求 ID
  2. 在搜索框粘贴
  3. 按回车搜索
日志占用多少存储空间?

取决于请求量和详细程度:

  • 平均每条日志 1-5 KB
  • 每天 10 万请求约 100-500 MB
  • 建议预留充足空间
可以删除特定日志吗?

可以,但需要管理员权限:

  • 按条件筛选
  • 选择要删除的日志
  • 确认删除

注意: 删除不可恢复

相关页面​

👥
用户管理
查看用户相关的访问日志
前往用户管理
🔑
Token 管理
查看 Token 的使用日志
前往 Token 管理
🌐
渠道管理
查看渠道的访问日志
前往渠道管理
⚙️
系统设置
配置日志保留和告警策略
前往系统设置