容器监控
容器监控页面用于监控和管理本地 Docker 容器的运行状态。通过该页面可以实时查看所有后端服务容器的运行状况，查看容器日志，以及重启容器等操作。
1. 进入容器监控
1.1 打开容器监控页面
点击顶部下拉列表菜单中的"容器监控"，进入容器监控页面。
2. 查看容器统计
2.1 统计卡片
页面顶部显示三个统计卡片，展示容器概况：
总容器数:
- 显示系统中所有 Docker 容器的总数
- 包括运行中和已停止的容器
- 蓝色图标标识
运行中:
- 显示当前正在运行的容器数量
- 绿色图标标识
- 健康状态的容器应该都在运行中
已停止:
- 显示已停止或退出的容器数量
- 橙色图标标识
- 需要关注停止的容器是否正常
3. 查看容器列表
3.1 列表字段说明
容器列表以表格形式展示，包含以下字段：
| 字段 | 说明 |
|---|---|
| 序号 | 当前页中的序号，自动计算，从 1 开始递增 |
| 容器名称 | Docker 容器的名称，通常是服务名称（如 cuemate-web-api、cuemate-asr 等），加粗显示，便于识别 |
| 镜像 | 容器使用的 Docker 镜像名称和版本，以代码格式显示 示例： registry.cn-beijing.aliyuncs.com/cuemate/cuemate-web-api:v0.1.0 |
| 运行状态 | 容器当前的运行状态，用不同颜色的标签显示： • 运行中：绿色标签 • 已停止：橙色标签 • 已退出：红色标签 • 已创建：蓝色标签 • 已暂停：紫色标签 |
| 端口 | 容器的端口映射信息，显示主机端口和容器端口的映射关系 如果端口超过 2 个，会显示"+N"表示还有更多端口 示例：3001:3001、10095:10095 |
| 大小 | 容器占用的磁盘空间大小，包括容器层和可写层的大小 |
| 操作 | • 重启：重启该容器 • 日志：打开日志侧拉弹框查看容器日志 |
3.2 分页功能
列表底部提供分页控件：
功能说明:
- 显示当前页码和总页数
- 显示总记录数
- 每页显示数量可选：10、20、50、100 条
- 切换页码查看更多容器
3.3 自动刷新
系统每 30 秒自动刷新一次容器列表，确保显示最新的容器状态。
4. 重启容器
4.1 重启单个容器
点击容器列表中的"重启"按钮，重启指定容器。
重启流程:
- 点击目标容器的"重启"按钮
- 弹出确认对话框："重启该服务可能会导致 CueMate 某些服务断开连接一段时间，确认重启吗？"
- 点击"确定"执行重启
- 显示全屏加载提示："正在重启容器，请稍候..."
- 重启完成后显示"容器重启成功"提示
- 列表自动刷新，显示最新状态
注意事项:
- 重启容器会导致服务短暂中断
- 重启过程通常需要几秒到几十秒
- 重启后容器会保持原有配置和数据
- 重启前请确保没有重要操作正在进行
适用场景:
- 容器出现异常需要重启恢复
- 配置更新后需要重启生效
- 内存泄漏需要重启释放资源
5. 查看容器日志
5.1 打开日志侧拉弹框
点击容器列表中的"日志"按钮，打开容器日志侧拉弹框。
弹框特性:
- 右侧侧拉弹框，占屏幕宽度 85%
- 显示容器的完整详细信息和日志内容
- 支持实时查看和刷新日志
5.2 容器信息
日志弹框顶部显示容器的详细信息：
基本信息:
- 容器名称
- 运行状态（带颜色标签）
- 镜像名称和版本
- 容器大小
- 状态描述
- 创建时间（本地时间格式）
端口信息:
- 显示所有端口映射
- 以绿色标签形式展示
- 格式：主机端口:容器端口
5.3 日志内容
弹框下方显示容器的运行日志：
日志查看器特性:
- 固定高度 400px，支持滚动查看
- 深色主题背景（黑底白字）
- 自动换行显示
- 显示完整的日志输出
日志来源:
- Docker 容器的标准输出（stdout）
- Docker 容器的标准错误（stderr）
- 实时获取最新日志内容
6. 日志操作
6.1 刷新日志
点击日志弹框右上角的"刷新"按钮，重新获取最新的容器日志。
刷新功能:
- 重新请求容器日志内容
- 获取最新的日志输出
- 刷新时显示加载状态
- 刷新完成后自动更新日志显示
使用场景:
- 查看最新的日志输出
- 排查问题时需要实时日志
- 验证操作是否生效
6.2 复制日志
点击日志弹框右上角的"复制"按钮，复制日志内容到剪贴板。
复制功能:
- 一键复制全部日志内容
- 使用现代剪贴板 API（navigator.clipboard）
- 自动降级到传统复制方法（兼容旧浏览器）
- 复制成功后显示"日志内容已复制到剪贴板"提示
使用场景:
- 保存日志内容到本地
- 分享日志给技术支持
- 在其他工具中分析日志
- 记录问题排查过程
7. 刷新容器列表
7.1 手动刷新
点击容器列表右上角的"刷新"按钮，手动刷新容器列表。
刷新功能:
- 重新获取所有容器的最新状态
- 更新统计卡片数据
- 刷新完成后显示"已刷新容器列表"提示
- 刷新时显示加载状态
使用场景:
- 查看容器状态变化
- 验证重启操作是否成功
- 检查新容器是否启动
- 确认容器是否停止
7.2 自动刷新
系统会自动刷新容器列表：
刷新策略:
- 每 30 秒自动刷新一次
- 静默刷新，不显示提示信息
- 自动更新统计数据和列表内容
- 离开页面后停止自动刷新
8. 容器服务说明
8.1 后端服务容器
CueMate 系统使用以下 Docker 容器提供服务：
Web 服务:
- cuemate-web - 主窗口服务
- 端口：80
- 提供主窗口服务访问
API 服务:
- cuemate-web-api - 后端 API 服务
- 端口：3001
- 提供业务逻辑和数据访问
LLM 路由服务:
- cuemate-llm-router - 大模型路由服务
- 端口：3002
- 路由和管理 LLM 请求
RAG 服务:
- cuemate-rag-service - 知识库检索服务
- 端口：3003
- 提供向量检索功能
语音识别服务:
- cuemate-asr - cuemate-asr 语音识别服务
- 端口：10095
- 提供实时语音转文本功能
向量数据库:
- cuemate-chroma - ChromaDB 向量数据库
- 端口：8000
- 存储和检索向量数据
8.2 服务依赖关系
依赖说明:
- Web 服务依赖 API 服务
- API 服务依赖 LLM 路由服务和 RAG 服务
- RAG 服务依赖 ChromaDB 向量数据库
- 桌面客户端依赖 ASR 语音识别服务
重启影响:
- 重启 Web 服务不影响其他服务
- 重启 API 服务会影响 Web 和桌面客户端
- 重启 LLM 路由服务会影响 AI 功能
- 重启 ASR 服务会影响语音识别功能
9. 日志查看技巧
9.1 常见日志内容
正常日志:
- 服务启动信息
- HTTP 请求日志
- 数据库连接日志
- 定时任务执行日志
错误日志:
- 异常堆栈信息
- 数据库连接失败
- 第三方服务调用失败
- 配置错误提示
性能日志:
- 请求响应时间
- 数据库查询时间
- 缓存命中率
- 资源使用情况
9.2 日志分析方法
定位问题:
- 查看最新的错误日志
- 搜索关键词（如 Error、Exception）
- 追踪请求 ID 或用户 ID
- 分析日志时间序列
排查步骤:
- 确定问题发生时间
- 查看对应时间段的日志
- 定位错误堆栈信息
- 分析错误原因
- 制定解决方案
10. 常见问题
10.1 容器状态异常
问题：容器显示"已退出"或"已停止"状态。
解决方案:
- 查看容器日志，定位退出原因
- 检查容器内服务是否正常启动
- 验证配置文件是否正确
- 尝试重启容器恢复服务
- 如果重启失败，查看详细错误信息
10.2 日志加载失败
问题：点击"日志"按钮，日志内容显示"获取日志失败，请检查后端服务是否正常运行"。
解决方案:
- 检查 Web API 服务是否正常运行
- 检查 Docker 服务是否正常
- 检查容器是否存在
- 刷新页面重试
- 查看浏览器控制台错误信息
10.3 重启容器失败
问题：点击"重启"按钮，提示"重启容器失败"。
解决方案:
- 检查是否有重启权限
- 检查 Docker 服务是否正常
- 查看容器是否被其他进程占用
- 查看 Web API 服务日志
- 尝试使用命令行手动重启：
docker restart <容器名称>
10.4 自动刷新不工作
问题：容器列表没有自动刷新，需要手动刷新才能看到最新状态。
解决方案:
- 确认页面没有被浏览器挂起
- 检查网络连接是否正常
- 查看浏览器控制台是否有错误
- 刷新页面重新加载
- 清除浏览器缓存
11. 最佳实践
11.1 日常监控
建议监控频率:
- 每日查看一次容器状态
- 关注"已停止"容器数量
- 定期查看容器日志
- 监控容器资源使用
11.2 问题排查
排查流程:
- 先查看统计卡片，确认异常容器数量
- 在列表中定位异常容器
- 打开日志弹框查看详细日志
- 复制日志内容进行分析
- 根据日志内容定位问题
- 尝试重启容器解决问题
11.3 日志管理
日志查看建议:
- 定期查看各服务日志
- 关注错误和异常日志
- 复制保存重要日志
- 结合操作记录分析问题