日志管理

日志管理页面用于查看、筛选和管理系统运行日志。支持按服务、级别、日期筛选日志文件,并提供查看、清理、删除等操作。

1. 进入日志管理

1.1 打开日志管理页面

点击顶部下拉列表菜单中的"日志管理",进入日志管理页面。

进入日志管理页面

2. 筛选日志

2.1 按项目筛选

在"项目"下拉框中选择要查看的服务。

筛选日志

支持的服务:

后端 API 服务 (web-api): Web API 服务日志
大模型路由服务 (llm-router): LLM 路由服务日志
RAG 知识库服务 (rag-service): 向量知识库服务日志
桌面客户端 (desktop-client): Electron 桌面应用日志

筛选说明:

选择"全部"显示所有服务的日志
选择具体服务只显示该服务的日志
切换服务后自动重置到第 1 页

使用场景:

排查特定服务的问题
查看某个服务的运行状态
分析服务之间的调用关系

2.2 按级别筛选

在"级别"下拉框中选择要查看的日志级别。

支持的级别:

DEBUG: 调试信息,详细的程序执行过程
INFO: 常规信息,正常的业务流程记录
WARN: 警告信息,可能存在的问题但不影响运行
ERROR: 错误信息,程序异常和错误

筛选说明:

选择"全部"显示所有级别的日志
选择具体级别只显示该级别的日志
级别使用不同颜色标签显示:
- DEBUG: 灰色
- INFO: 蓝色
- WARN: 黄色
- ERROR: 红色

使用场景:

查看 ERROR 日志快速定位错误
查看 WARN 日志发现潜在问题
查看 INFO 日志了解业务流程
查看 DEBUG 日志进行详细调试

2.3 按日期筛选

点击"日期"选择器,选择要查看的日志日期。

日期选择:

点击日期输入框打开日历选择器
选择具体日期只显示该日期的日志
清空日期显示所有日期的日志

使用场景:

查看特定日期的系统运行情况
回溯历史问题发生的时间点
分析系统在某个时间段的表现

2.4 组合筛选

可以同时使用项目、级别、日期三个筛选条件进行组合筛选。

组合示例:

项目: web-api + 级别: ERROR → 查看 Web API 服务的所有错误日志
项目: llm-router + 日期: 2026-01-15 → 查看 LLM 路由服务在 2026-01-15 的所有日志
级别: WARN + 日期: 2026-01-15 → 查看所有服务在 2026-01-15 的警告日志
项目: rag-service + 级别: ERROR + 日期: 2026-01-15 → 精确定位特定服务、特定日期的错误日志

3. 日志列表

3.1 列表字段说明

日志列表以表格形式展示,包含以下字段:

日志列表

序号:

当前页中的序号
自动计算,从 1 开始递增

名称:

服务的中文名称
便于快速识别服务

项目:

服务的英文标识符
用于技术排查和日志定位

级别:

日志级别标签
带图标和颜色,方便快速识别
DEBUG (灰色), INFO (蓝色), WARN (黄色), ERROR (红色)

日期:

日志文件的日期
格式: YYYY-MM-DD (例如 2026-01-15)

大小:

日志文件大小
单位: KB
显示一位小数 (例如 125.6 KB)

操作:

查看按钮 (蓝色): 打开日志查看器,查看完整日志内容
清理按钮 (黄色): 清空日志文件内容,但不删除文件
删除按钮 (红色): 完全删除日志文件

3.2 分页功能

分页控制:

底部显示总记录数 (例如"共 45 条")
支持切换每页显示数量: 10/20/50/100
支持翻页,自动计算总页数
切换每页数量后自动重置到第 1 页

使用场景:

日志较多时,使用分页浏览
调整每页数量,快速浏览大量日志
通过页码跳转到指定页面

4. 查看日志

4.1 打开日志查看器

点击日志列表中的"查看"按钮,打开日志查看器侧拉弹框。

查看器特性:

右侧侧拉弹框,占屏幕宽度 85%
显示日志文件的完整内容
支持滚动查看长日志
显示日志级别、服务名称、日期、总行数

查看日志

4.2 日志查看器界面

顶部标题区域:

服务图标和中文名称
日志级别标签 (不同颜色)
日期显示
总行数统计 (例如"123 行日志")

工具栏:

全选复选框: 选择/取消选择所有日志行
已选择数量显示 (例如"已选择 5 行")
"复制选中"按钮: 复制选中的日志行到剪贴板
"复制全部"按钮: 复制所有日志内容到剪贴板

日志内容区域:

每行日志显示为独立卡片
左侧复选框用于选择该行
行号显示 (从 1 开始)
日志内容显示:
- JSON 格式日志使用等宽字体和语法高亮
- 普通文本日志使用正常字体
鼠标悬停显示选择提示
点击日志行切换选择状态

4.3 选择和复制日志

单行选择:

点击日志行的复选框或整行
选中的行显示蓝色高亮背景
再次点击取消选择

多行选择:

依次点击多个日志行
所有选中的行显示蓝色高亮背景
工具栏显示已选择的数量

全选操作:

点击工具栏的"全选"复选框
所有日志行被选中
再次点击取消全选

复制选中内容:

选择一行或多行日志
点击"复制选中"按钮
选中的日志内容复制到剪贴板
显示成功提示 (例如"已复制 5 行日志到剪贴板")

复制全部内容:

点击"复制全部"按钮
所有日志内容复制到剪贴板
显示成功提示 "已复制全部日志到剪贴板"

使用场景:

选择关键日志行复制到问题报告
复制错误堆栈信息发送给技术支持
导出特定日志片段用于分析
复制全部日志内容进行本地分析

4.4 关闭日志查看器

点击右上角"×"按钮或按 ESC 键关闭日志查看器。

5. 清理日志

5.1 清理单个日志文件

点击日志列表中的"清理"按钮,清空该日志文件的内容。

清理确认弹框:

显示要清理的日志文件信息:
- 服务名称
- 日志级别
- 日期
- 文件大小
黄色警告提示: "清理后日志内容将无法恢复！"
两个操作按钮:
- "确认清理": 执行清理操作
- "取消": 放弃清理

清理结果:

清理成功显示提示 "日志清理成功"
日志文件内容被清空,但文件本身保留
文件大小变为 0 或接近 0 KB
列表自动刷新,显示更新后的文件大小

使用场景:

日志文件过大,需要释放存储空间
清除已处理完的错误日志
定期清理不再需要的历史日志
保留文件结构,但清空内容

重要提示:

清理操作不可逆,请确认不需要该日志内容后再操作
清理只影响文件内容,不删除文件本身
建议在排查完问题后再清理日志

清理日志

5.2 清理今日日志

点击顶部"清理今日日志"按钮,批量清空所有今日产生的日志文件内容。

清理确认弹框:

黄色警告区域显示清理范围:
- 此操作将清理所有服务、所有级别的今日日志内容
- 时间范围: 从今日 00:00 到现在
- 仅清理日志内容,不会删除日志文件
- 清理后日志内容将无法恢复
- 建议在确认无重要日志后再执行此操作
两个操作按钮:
- "确认清理": 执行批量清理
- "取消": 放弃清理

清理结果:

清理成功显示提示 (例如"今日日志清理成功,共清理 12 个日志文件")
所有今日日志文件内容被清空
列表自动刷新,显示更新后的状态

使用场景:

每日工作结束后清理临时日志
测试完成后清理测试日志
定期维护,释放存储空间
批量清理不再需要的当日日志

重要提示:

此操作影响所有服务的今日日志,请谨慎使用
清理前建议先查看是否有重要日志需要保留
如果只需要清理特定服务或级别的日志,请使用单个文件清理功能

清理今日日志

6. 删除日志

6.1 删除日志文件

点击日志列表中的"删除"按钮,完全删除该日志文件。

删除确认弹框:

显示要删除的日志文件信息:
- 服务名称
- 日志级别
- 日期
- 文件大小
红色危险提示:
- "删除后日志文件将完全消失,无法恢复！"
- "此操作比清理更加危险,请谨慎操作！"
两个操作按钮:
- "确认删除" (红色危险按钮): 执行删除操作
- "取消": 放弃删除

删除结果:

删除成功显示提示 "日志文件已删除"
日志文件完全消失,无法恢复
列表自动刷新,该日志文件不再显示

清理 vs 删除:

操作	文件	内容	恢复	危险性
清理	保留	清空	不可恢复	中等
删除	删除	删除	不可恢复	高

使用场景:

确认不再需要某个日志文件
彻底清理历史日志,释放存储空间
删除包含敏感信息的日志文件
归档后删除本地日志文件

重要提示:

删除操作不可逆,请务必确认不需要该日志文件
删除比清理更加危险,请谨慎使用
建议先清理日志内容,确认不影响后再删除文件
对于可能用于问题排查的日志,建议导出备份后再删除

删除日志

7. 刷新日志列表

7.1 手动刷新

点击顶部"刷新"按钮,重新加载日志列表和服务列表。

刷新内容:

重新获取服务列表
重新加载日志文件列表
更新文件大小信息
更新文件修改时间

使用场景:

后台生成了新的日志文件
执行清理或删除操作后
确认其他操作的结果
定期刷新查看最新状态

刷新日志

7.2 自动刷新

触发自动刷新的操作:

清理单个日志文件后
删除日志文件后
清理今日日志后
切换筛选条件后 (项目/级别/日期)
切换分页后

8. 日志文件存储

8.1 日志存储位置

macOS 系统:

~/Library/Application Support/cuemate-desktop-client/data/logs/{service}/{date}/{level}.log

路径说明:

{service}: 服务名称 (web-api/llm-router/rag-service/cuemate-asr/desktop-client)
{date}: 日期 (YYYY-MM-DD)
{level}.log: 日志文件名 (debug.log/info.log/warn.log/error.log)

示例路径:

~/Library/Application Support/cuemate-desktop-client/data/logs/web-api/2026-01-15/error.log

8.2 日志文件格式

JSON 格式日志:

json

{"level":"error","time":"2026-01-15T10:30:45.123Z","service":"web-api","message":"Database connection failed","stack":"..."}

文本格式日志:

[2026-01-15 10:30:45] ERROR: Database connection failed

8.3 日志滚动和归档

日志滚动策略:

按日期分割日志文件
每天生成新的日志文件
旧日志文件自动归档

日志保留时间:

默认保留 30 天
可在系统设置中调整
超过保留时间的日志自动删除

9. 最佳实践

9.1 日常维护

建议操作:

每周检查一次 ERROR 和 WARN 日志
定期清理不需要的历史日志
保留最近 7-30 天的日志用于问题排查
遇到问题时及时查看日志定位原因

9.2 问题排查流程

排查步骤:

确定问题发生的时间和相关服务
使用筛选条件定位到相关日志文件
打开日志查看器查看完整日志内容
搜索关键错误信息或堆栈跟踪
分析错误原因,制定解决方案
修复问题后验证日志是否恢复正常

排查技巧:

先查看 ERROR 级别日志
结合 WARN 级别日志分析潜在问题
对比正常日志和异常日志
追踪请求 ID 定位完整调用链

9.3 日志清理策略

清理建议:

问题排查完成后清理相关日志
每周清理一次 DEBUG 和 INFO 日志
每月清理一次 WARN 日志
ERROR 日志建议保留 30 天以上
清理前先导出重要日志内容

清理优先级:

高优先级: DEBUG 日志 (占用空间大,价值低)
中优先级: INFO 和 WARN 日志 (定期清理)
低优先级: ERROR 日志 (保留时间长)

9.4 日志分析

分析维度:

错误频率: 统计 ERROR 日志的出现频率
错误类型: 分类不同的错误信息
服务健康: 对比各服务的日志级别分布
时间趋势: 分析不同时间段的日志变化

分析工具:

使用日志查看器的选择和复制功能
导出日志到本地进行统计分析
使用筛选条件快速定位关键日志
结合容器监控查看服务状态

10. 常见问题

10.1 日志文件过大

问题: 某个日志文件大小超过 100 MB,打开很慢。

解决方案:

使用"清理"功能清空日志内容
或者使用"删除"功能删除文件
检查是否有日志输出过于频繁的问题
调整日志级别,减少不必要的日志输出

10.2 找不到日志文件

问题: 筛选后列表为空,找不到想要的日志文件。

解决方案:

检查日期选择是否正确
尝试清空所有筛选条件,查看全部日志
确认服务是否在该日期有日志输出
检查日志存储目录是否正常

10.3 日志查看器打不开

问题: 点击"查看"按钮,日志查看器没有打开或显示空白。

解决方案:

检查日志文件是否存在
检查日志文件权限是否正常
尝试刷新页面后重新打开
查看浏览器控制台是否有错误信息

10.4 复制日志失败

问题: 点击"复制选中"或"复制全部"按钮,提示复制失败。

解决方案:

检查浏览器是否允许剪贴板访问
尝试手动选择日志内容复制
确认选中的日志行不为空
检查浏览器权限设置

模型设置

日志管理

1. 进入日志管理

1.1 打开日志管理页面

2. 筛选日志

2.1 按项目筛选

2.2 按级别筛选

2.3 按日期筛选

2.4 组合筛选

3. 日志列表

3.1 列表字段说明

3.2 分页功能

4. 查看日志

4.1 打开日志查看器

4.2 日志查看器界面

4.3 选择和复制日志

4.4 关闭日志查看器

5. 清理日志

5.1 清理单个日志文件

5.2 清理今日日志

6. 删除日志

6.1 删除日志文件

7. 刷新日志列表

7.1 手动刷新

7.2 自动刷新

8. 日志文件存储

8.1 日志存储位置

8.2 日志文件格式

8.3 日志滚动和归档

9. 最佳实践

9.1 日常维护

9.2 问题排查流程

9.3 日志清理策略

9.4 日志分析

10. 常见问题

10.1 日志文件过大

10.2 找不到日志文件

10.3 日志查看器打不开

10.4 复制日志失败

相关页面

日志管理 ​

1. 进入日志管理 ​

1.1 打开日志管理页面 ​

2. 筛选日志 ​

2.1 按项目筛选 ​

2.2 按级别筛选 ​

2.3 按日期筛选 ​

2.4 组合筛选 ​

3. 日志列表 ​

3.1 列表字段说明 ​

3.2 分页功能 ​

4. 查看日志 ​

4.1 打开日志查看器 ​

4.2 日志查看器界面 ​

4.3 选择和复制日志 ​

4.4 关闭日志查看器 ​

5. 清理日志 ​

5.1 清理单个日志文件 ​

5.2 清理今日日志 ​

6. 删除日志 ​

6.1 删除日志文件 ​

7. 刷新日志列表 ​

7.1 手动刷新 ​

7.2 自动刷新 ​

8. 日志文件存储 ​

8.1 日志存储位置 ​

8.2 日志文件格式 ​

8.3 日志滚动和归档 ​

9. 最佳实践 ​

9.1 日常维护 ​

9.2 问题排查流程 ​

9.3 日志清理策略 ​

9.4 日志分析 ​

10. 常见问题 ​

10.1 日志文件过大 ​

10.2 找不到日志文件 ​

10.3 日志查看器打不开 ​

10.4 复制日志失败 ​

相关页面 ​

日志管理

1. 进入日志管理

1.1 打开日志管理页面

2. 筛选日志

2.1 按项目筛选

2.2 按级别筛选

2.3 按日期筛选

2.4 组合筛选

3. 日志列表

3.1 列表字段说明

3.2 分页功能

4. 查看日志

4.1 打开日志查看器

4.2 日志查看器界面

4.3 选择和复制日志

4.4 关闭日志查看器

5. 清理日志

5.1 清理单个日志文件

5.2 清理今日日志

6. 删除日志

6.1 删除日志文件

7. 刷新日志列表

7.1 手动刷新

7.2 自动刷新

8. 日志文件存储

8.1 日志存储位置

8.2 日志文件格式

8.3 日志滚动和归档

9. 最佳实践

9.1 日常维护

9.2 问题排查流程

9.3 日志清理策略

9.4 日志分析

10. 常见问题

10.1 日志文件过大

10.2 找不到日志文件

10.3 日志查看器打不开

10.4 复制日志失败

相关页面