理解 Open WebUI 日志记录 🪵

日志记录对于调试、监控和理解 Open WebUI 的行为至关重要。本指南解释了日志记录在浏览器客户端（前端）和应用程序服务器/后端中的工作方式。

🖥️ 浏览器客户端日志记录（前端）

对于前端开发和调试，Open WebUI 利用标准的浏览器控制台日志记录。这意味着你可以在网络浏览器的内置开发者工具中直接查看日志。

如何访问浏览器日志

打开开发者工具：在大多数浏览器中，你可以通过以下方式打开开发者工具：
- 在 Open WebUI 页面上的任意位置右键单击并选择“检查”或“检查元素”。
- 按下 F12（或在 macOS 上按下 Cmd+Opt+I）。
导航到“控制台”选项卡：在开发者工具面板中，找到并点击“控制台”选项卡。

浏览器日志类型

Open WebUI 主要使用 JavaScript 的 console.log() 进行客户端日志记录。你会在控制台中看到各种类型的消息，包括：

浏览器特定的开发者工具

不同的浏览器提供略有不同的开发者工具，但它们都提供了用于查看 JavaScript 日志的控制台。以下是流行浏览器的文档链接：

Open WebUI 的后端使用 Python 内置的 logging 模块来记录服务器端的事件和信息。这些日志对于理解服务器行为、诊断错误和监控性能至关重要。

关键概念

Python logging 模块： Open WebUI 利用标准的 Python logging 库。如果你熟悉 Python 日志记录，你会发现本节内容很简单。（如需更深入的信息，请参阅Python 日志记录文档）。
控制台输出： 默认情况下，后端日志会发送到控制台（标准输出），使其在你的终端或 Docker 容器日志中可见。
日志级别： 日志级别控制日志的详细程度。你可以根据这些级别配置 Open WebUI 显示更多或更少详细的信息。

Python 日志记录使用分层级别来按严重性对日志消息进行分类。以下是各级别的细分，从最严重到最不严重：

级别	数值	描述	用例
`CRITICAL (严重)`	50	可能导致应用程序终止的严重错误。	灾难性故障、数据损坏。
`ERROR (错误)`	40	指示存在问题但应用程序可能仍能运行的错误。	可恢复错误、操作失败。
`WARNING (警告)`	30	应调查的潜在问题或意外情况。	弃用警告、资源限制。
`INFO (信息)`	20	关于应用程序操作的一般信息消息。	启动消息、关键事件、正常操作流程。
`DEBUG (调试)`	10	为开发人员提供的详细调试信息。	函数调用、变量值、详细执行步骤。
`NOTSET (未设置)`	0	所有消息都将被记录。（如果未设置，通常默认为 `WARNING`）。	用于捕获所有信息，通常用于非常具体的调试。

默认级别： Open WebUI 的默认日志级别是 INFO。

你可以使用 GLOBAL_LOG_LEVEL 环境变量更改整个 Open WebUI 后端的全局日志级别。这是控制整体日志详细程度最直接的方法。

工作原理

设置 GLOBAL_LOG_LEVEL 会配置 Python 中的根记录器，影响 Open WebUI 中的所有记录器以及可能使用 basicConfig 的一些第三方库。它使用 logging.basicConfig(force=True)，这意味着它将覆盖任何现有的根记录器配置。

示例：设置为 DEBUG

Docker 参数
```
--env GLOBAL_LOG_LEVEL="DEBUG"
```
Docker Compose (docker-compose.yml)
```
environment:
  - GLOBAL_LOG_LEVEL=DEBUG
```

影响： 将 GLOBAL_LOG_LEVEL 设置为 DEBUG 将产生最详细的日志，包括对开发和故障排除有帮助的详细信息。对于生产环境，INFO 或 WARNING 可能更合适，以减少日志量。

为了更精细的控制，Open WebUI 提供了环境变量来为特定的后端组件设置日志级别。日志记录仍在持续开发中，但通过这些环境变量可以实现一定程度的控制。这些变量允许你对应用程序的不同部分进行日志记录微调。

可用的环境变量

环境变量	组件/模块	描述
`AUDIO_LOG_LEVEL`	音频处理	与音频转录 (faster-whisper)、文本转语音 (TTS) 和音频处理相关的日志记录。
`COMFYUI_LOG_LEVEL`	ComfyUI 集成	与 ComfyUI 交互的日志记录，如果你正在使用此集成。
`CONFIG_LOG_LEVEL`	配置管理	与加载和处理 Open WebUI 配置文件相关的日志记录。
`DB_LOG_LEVEL`	数据库操作 (Peewee)	使用 Peewee ORM（对象关系映射器）进行数据库交互的日志记录。
`IMAGES_LOG_LEVEL`	图像生成 (AUTOMATIC1111/Stable Diffusion)	图像生成任务的日志记录，特别是在使用 AUTOMATIC1111 Stable Diffusion 集成时。
`MAIN_LOG_LEVEL`	主应用程序执行（根记录器）	来自主应用程序入口点和根记录器的日志记录。
`MODELS_LOG_LEVEL`	模型管理	与加载、管理和与语言模型（LLM）交互相关的日志记录，包括身份验证。
`OLLAMA_LOG_LEVEL`	Ollama 后端集成	与 Ollama 后端通信和交互的日志记录。
`OPENAI_LOG_LEVEL`	OpenAI API 集成	与 OpenAI API 交互的日志记录（例如，对于 GPT 等模型）。
`RAG_LOG_LEVEL`	检索增强生成 (RAG)	RAG 管道的日志记录，包括 Chroma 向量数据库和 Sentence-Transformers。
`WEBHOOK_LOG_LEVEL`	身份验证 Webhook	身份验证 Webhook 功能的扩展日志记录。

如何使用

你可以像设置 GLOBAL_LOG_LEVEL 那样设置这些环境变量（Docker 参数，Docker Compose 的 environment 部分）。例如，为了获取更详细的 Ollama 交互日志，你可以设置：

environment:
  - OLLAMA_LOG_LEVEL=DEBUG

重要提示： 与 GLOBAL_LOG_LEVEL 不同，这些应用程序特定的变量可能不会影响来自所有第三方模块的日志记录。它们主要控制 Open WebUI 代码库内部的日志记录。

通过理解和利用这些日志机制，你可以有效地监控、调试并深入了解你的 Open WebUI 实例。