Skip to main content
LangChat Pro 对大多数接口请求与关键操作进行日志记录(高频 GET 与 Chat 流式请求默认不入库,以避免性能开销)。日志管理页面用于检索、定位与审计平台行为。

概述

后端在控制器层通过注解与 AOP 采集操作日志:
@ApiLog("新增插件")
AOP 拦截记录调用信息(操作者、接口、参数、耗时、结果等): image-20250926154825209 该页面提供日志查看与删除能力。

日志模型(示例)

  • 请求信息:URL、Method、IP、User-Agent
  • 操作者:userId/username、角色、部门(可选)
  • 参数与结果:入参摘要、响应摘要(敏感信息脱敏/省略)
  • 时间与耗时:请求时间、处理耗时
  • 追踪标识:traceId/spanId 便于链路追踪(可选)
  • 结果状态:成功/失败、错误码与错误消息
建议对入参/出参中的敏感数据进行脱敏或不落库,仅保留必要的定位信息。

查询与导出

  • 条件筛选:按时间范围、操作者、URL、状态进行检索
  • 关键词搜索:支持对入参/响应摘要关键字匹配
  • 分页/排序:按时间、耗时、状态排序
  • 导出:导出为 CSV/Excel(可选),用于审计归档

采集机制与性能

  • AOP 切面:在控制器切面记录请求上下文与结果
  • 异步落库:推荐异步队列/批量写入,减小请求时延
  • 高频请求豁免:对高频 GET 与流式 Chat 默认不入库
  • 可配置开关:在配置中心启停或调整日志粒度

最佳实践

  • 字段脱敏:手机号、邮箱、Token 等敏感字段脱敏或不记录
  • 容量治理:设置保留周期与自动归档,防止库表膨胀
  • 告警联动:与监控系统对接,对异常错误率/耗时波动告警
  • 审计合规:记录操作人、时间、影响对象、IP 与定位信息

常见问题(FAQ)

  • 为何看不到 Chat 请求日志?
    • Chat 为高频流式调用,默认不入库以降低 IO 与存储成本
  • 如何定位一次完整调用链?
    • 开启 traceId 透传,与网关/应用/APM 联动查询
  • 删除日志后能否恢复?
    • 建议先导出归档;如需恢复能力,请对接冷存储/对象存储策略