LangChat Pro 对大多数接口请求与关键操作进行日志记录(高频 GET 与 Chat 流式请求默认不入库,以避免性能开销)。日志管理页面用于检索、定位与审计平台行为。
概述
后端在控制器层通过注解与 AOP 采集操作日志:
该页面提供日志查看与删除能力。
日志模型(示例)
- 请求信息:URL、Method、IP、User-Agent
- 操作者:userId/username、角色、部门(可选)
- 参数与结果:入参摘要、响应摘要(敏感信息脱敏/省略)
- 时间与耗时:请求时间、处理耗时
- 追踪标识:traceId/spanId 便于链路追踪(可选)
- 结果状态:成功/失败、错误码与错误消息
建议对入参/出参中的敏感数据进行脱敏或不落库,仅保留必要的定位信息。
查询与导出
- 条件筛选:按时间范围、操作者、URL、状态进行检索
- 关键词搜索:支持对入参/响应摘要关键字匹配
- 分页/排序:按时间、耗时、状态排序
- 导出:导出为 CSV/Excel(可选),用于审计归档
采集机制与性能
- AOP 切面:在控制器切面记录请求上下文与结果
- 异步落库:推荐异步队列/批量写入,减小请求时延
- 高频请求豁免:对高频 GET 与流式 Chat 默认不入库
- 可配置开关:在配置中心启停或调整日志粒度
最佳实践
- 字段脱敏:手机号、邮箱、Token 等敏感字段脱敏或不记录
- 容量治理:设置保留周期与自动归档,防止库表膨胀
- 告警联动:与监控系统对接,对异常错误率/耗时波动告警
- 审计合规:记录操作人、时间、影响对象、IP 与定位信息
常见问题(FAQ)
- 为何看不到 Chat 请求日志?
- Chat 为高频流式调用,默认不入库以降低 IO 与存储成本
- 如何定位一次完整调用链?
- 开启 traceId 透传,与网关/应用/APM 联动查询
- 删除日志后能否恢复?
- 建议先导出归档;如需恢复能力,请对接冷存储/对象存储策略

