使用控制面板获取应用日志

[marvin113]

在使用 Olares 系统的过程中，如果遇到应用无法打开、下载失败、外网访问异常或系统状态异常等问题，可以通过控制面板应用诊断排查问题。本教程将详细介绍如何通过控制面板诊断问题应用的异常状态、查看容器日志并导出日志文件。

控制面板应用诊断逻辑

1. 判断异常应用的类别。

2. 在控制面板的浏览视图 (Browse) 里找到对应的应用或服务。

3. 查看部署（Deployments）下的异常容器组状态**：**

   a. 先查看事件（Events） 获取初步结论。

   b. 如事件不足以判断，再查看容器日志进行细致诊断。

判断应用类别

控制面板的浏览视图会以树状结构展示集群中的所有命名空间和应用，你可以根据应用的类型来确定查找位置：

• 用户命名空间：每个 Olares 用户的独立命名空间，包含社区应用，用户内置应用，和用户系统服务三类。

  • community-app-olares-id: 用户自己安装的社区应用，如 Ollama、Dify、ComfyUI 等。

    

  • user-space-olares-id：用户内置应用，包括文件管理器、Wise、Market、控制面板、仪表盘、 Vault 等。

    

  • user-system-olares-id：与用户相关的系统程序，包括 Olares 应用运行时组件、调度程序和跨应用交互代理。

    

    注意

    只有管理员账户才可以看到 os-system 命名空间。

初步诊断：查看 Pod 状态和异常事件

从对应的空间下找到出问题的应用后，点击进入，可在第二栏部署 (Deployments)下逐级展开该应用的容器组（Pod）。我们可以通过下标状态标识判断处于异常状态（）的容器，并通过事件快速定位问题。此处以 Steam Headless 应用为例：

1. 在浏览视图第二栏点击问题应用下的容器组，并快速定位异常容器组。下图中可以看到 Steam Headless 的容器组处于 ImagePullBackOff异常状态。

   

   常见的异常状态

   • 镜像拉取失败（ImagePullBackOff）
   • 容器启动后崩溃退出（CrashLoopBackOff）
   • 内存用量超过限制（OOMKilled）
   • Pod （因磁盘、内存资源不足）被终止移除 （PodEvicted）

2. 点击容器组，可展开容器组下所有容器并看到引起异常的具体容器：
   

   

3. 下拉页面至底部，在事件下，找到对应的异常事件，如下图:

   

   我们可在事件日志中看到具体是哪一个镜像拉取引起的异常。

查看并下载容器日志

如果事件里提供的异常信息不足以诊断问题，可以进一步查看容器的日志。

1. 进入容器明细页面，找到异常状态容器，点击右侧 图标。
   

   

2. 在弹出的日志窗口里按照需要获取日志：
   

   
   • 点击 按钮以下载完整日志文件。
   • 点击 按钮以查看当前日志的最新条目。
   • 点击 / 启用实时滚动查看新日志，或暂停滚动定位历史日志。