跳到主要内容

系统诊断与用量分析

Libre WebUI 为管理员提供两个实例实时视图：系统页面显示主机和运行时诊断， 用量页面显示模型和提供商分析。后端和界面都仅允许管理员访问。读取这两个页面 不会离开部署；可选外部遥测是由运维人员配置的独立可观测性路径。

可从侧边栏管理员入口、标签菜单快捷方式或 /system 和 /usage 直接访问。非管理员 无法打开；账户失去 admin 角色时，管理员标签会关闭。

系统诊断​

系统页面（/system）报告：

  • 主机：主机名、平台、内核版本、架构、运行时间、逻辑 CPU 数、CPU 型号、 平均负载以及进程是否像在容器中运行。没有 CPU 使用率百分比，只有平均负载。
  • 运行时：应用版本、Node.js 版本、进程 ID、进程运行时间和工作目录。
  • 内存：主机总内存、空闲和已用内存，以及进程 RSS 和 heap。
  • 文件系统：运行时文件系统（/）和数据目录（DATA_DIR）的容量与使用情况。
  • 网络：接口名称和地址；Linux 上还显示收发字节计数。
  • Docker：引擎版本、主机操作系统、内核、CPU、内存、容器数量和精简容器列表， 前提是 socket 可用。

标签页获得焦点时每 30 秒刷新，也可手动刷新。后端端点为 GET /api/system，受身份 验证、有效管理员角色和每用户每 15 分钟 120 个请求限制保护。响应绝不缓存 （Cache-Control: no-store），每次请求都收集新值。

Docker socket 依赖​

解析顺序与 Work 和交互终端相同：先使用 WORK_DOCKER_SOCKET（始终为本地 Unix socket 路径），否则使用 DOCKER_HOST（unix:// URL 或普通 HTTP tcp://， 如过滤的 Docker API 代理），最后使用 /var/run/docker.sock。明确不查询 ssh://、npipe:// 或启用 TLS 验证的 tcp://。请求严格为只读引擎 GET （版本、信息、容器列表），超时 4 秒且响应大小受限，列表最多 100 项。

没有可用 socket 时其余页面仍工作；Docker 面板会说明未挂载、不可读、daemon 不可达或远程端点，而不是让整个请求失败。

页面揭示的信息与访问者​

容器列表有意只含短 ID、名称、镜像、状态和创建时间。环境变量、标签、挂载、 容器命令、inspect 负载和凭据绝不包含。

页面仍会显示真实基础设施详情：主机名、工作目录、内部 IP 以及 Docker 主机上的 所有容器，而不仅是 Libre WebUI。它符合信任模型：Docker 部署中的 Libre WebUI 管理员实际也是主机管理员（参见 Docker）。请谨慎授予 admin。

用量分析​

用量页面展示归因到用户的模型和提供商工作。计量覆盖：

  • 本地 Ollama 聊天调用，包括原生 Chat 和由 Ollama 支持的 Work 调用；
  • 已安装智能体 CLI 的聊天调用及 Strands 引擎调用；
  • 插件支持的流式及非流式聊天；
  • 插件嵌入、图像生成、语音转文本、文本转语音、声音和视频；
  • 插件支持的 Work 调用。

没有所属用户的后台操作不会归到虚拟账户，因此不计量。失败或取消的调用仍会记录。

每个事件记录：

  • 提供商或插件 ID 及其显示名称快照（ollama 和 agent-cli:* 与插件提供商使用同一账本）
  • 能力（chat、embedding、image、stt、tts、audio、video）
  • 模型
  • 状态：success、error 或 cancelled（中止的流记为取消）
  • 令牌计数，仅在提供商返回用量元数据时记录
  • 与能力对应的单位计数：TTS 字符数、图像数、嵌入输入数、视频任务数或音频字节数
  • 端到端时长与时间戳
  • 请求用户 ID

不存储其他内容。提示词、回复、提供商端点、凭据和错误正文绝不会写入用量表； 失败调用只记录为 status = 'error'。事件保存在所选应用数据库（单机模式 SQLite、 团队模式 PostgreSQL）中 400 天；旧行在写入时机会性清理，每天最多一次。 计量只尽最大努力，绝不能导致模型或提供商请求失败。

页面通过仅管理员端点 GET /api/plugins/usage?days=<1..365>（默认 30）提供 7、30 和 90 天范围，显示总调用、报告令牌、成功率、平均延迟，以及报告了令牌用量的调用占比。 阅读该页面是只读操作，使用部署中已有的用量账本。

智能体用量​

页面顶部附近的智能体区域（对 CLI 智能体和 Strands 引擎的调用）分别显示 Claude Code、Codex、OpenCode、Pi 和 Strands，包括各智能体的调用次数、报告的令牌数、失败或取消次数、平均时长，以及最多 20 个常用模型。智能体总量覆盖所选时间段内所有匹配调用，不受更大提供商和模型表格的显示上限影响。这些数据是页面总量的子集，不是额外计费事件。

没有记录的智能体显示此期间没有记录的调用，这并不说明其 CLI 是否已安装或登录。缺少报告令牌元数据的调用显示未报告令牌数，不会估算缺失计数。页面可见时每 20 秒刷新一次，也支持手动刷新。

CLI 用量记录一次调用及该 CLI 报告的令牌数。累计快照替换旧快照，重复分步报告会去重。缓存和推理计数按各 CLI 协议合并，不会重复计算子集。被取消的调用及以失败状态退出的部分响应保留其真实结果。

Strands 调用会计入 Strands 智能体。该引擎没有自己的模型提供商；它发出的每次模型调用都经过 Libre WebUI 的 Ollama 或插件提供商。LWUI 之外的调用不会导入，没有令牌计数的旧记录仍保持未计量。

端点通过 agents 字段提供有界明细，即使计数为零也包含五个受支持的名称。读取此字段不会发现 CLI 模型、启动智能体或联系提供商。没有该字段的旧服务器可以从提供商明细显示已有智能体记录，但缺失的智能体条目不会被当作已确认的零用量。

探索模型与提供商​

模型配色把每日图表、年度活动日历、模型表和提供商条形图串联起来。除颜色外还会显示模型名称、 数值和选中标记。活动日历始终覆盖最近 365 天，与所选范围无关；每一天的颜色代表当天使用最多的模型。

每日图表可在调用和 Token 之间切换。把指针悬停在图例中的某个模型上，或用键盘将焦点移到它上面， 即可描摹该模型的折线。选中模型可让它保持高亮，再次选中即可取消，或者选择显示所有模型复位。 模型表中也提供高亮操作。高亮只改变强调方式，不会改变每日合计、表格数值和提供商合计。

在图表上移动指针，或使用查看每日用量，即可查看某一天的合计及其模型构成。每日滑块支持键盘操作： 方向键在天之间移动，Home/End 跳到第一天/最后一天。每日分桶及其标签使用 UTC。

默认情况下，图表显示所选期间内按调用次数排名前 12 的模型名称，查看 Token 时同样如此。每个模型仍可 单独查看：在表格或提供商详情中聚焦或选中某个模型，即可加载它精确的每日折线，即使它不在这 12 个之内。 加载提示会写明正在请求的模型名称。

额外加载的模型折线会从其他模型中分离出来，剩余分组不再计入它的调用、报告令牌和失败次数。图表最多 包含 13 条具名模型折线加上剩余分组，且每日数值仍与相同的合计相符。选择显示所有模型可回到默认视图。

每日折线会把不同提供商中记录名称相同的调用合并在一起。模型表仍保留各自的提供商/模型条目，因此同一个 模型可能出现在多个提供商下。具名模型在表格和提供商条形图中保持各自的颜色，包括默认图表之外的模型。

提供商详情会显示每个提供商的请求占比、按模型划分的条形图、报告的令牌数、失败或取消的调用以及平均响应 时间。能力组合仍位于模型和提供商细分的下方。

令牌总数只含提供商报告用量元数据的调用。覆盖率百分比让不完整的报告变得可见；缺失的令牌数绝不会根据 请求数或其他模型推算。若某个期间没有任何报告的令牌，Token 视图会给出说明，其请求历史仍可在调用视图中 查看。

该端点在 modelSeries 中包含每日模型数据点。可选的 model 查询参数用于在默认的前 12 名之外，请求 一个精确记录的模型名称，例如 GET /api/plugins/usage?days=30&model=<encoded-model-name>。它仍是同一个 仅限管理员的只读端点：只查询本地用量账本，绝不调用模型提供商来获取历史数据。

可选的 to 参数把请求的结束边界固定为以毫秒为单位的 Unix 时间戳。它需要同时提供 model，并且只接受 不迟于服务器当前时间的非负安全整数。浏览器在加载单个模型时会发送概览的 range.to，以保持其 UTC 日界和 年界，并排除该时间戳之后的调用。未提供 to 时，端点使用当前时间。

加载某个模型不会改变概览的卡片、表格、提供商合计和配色。只有当响应的时间边界和每日合计与该概览一致时， 才会加入它的每日折线。时间边界并不会冻结数据库：如果历史回填或删除改变了这些合计，浏览器会先刷新概览， 然后再显示模型折线。

如果较旧的服务器没有返回 modelSeries，图表会显示聚合的所有模型序列，并说明模型细分不可用。 模型表仍然可用；浏览器不会根据期间合计或年度日历推断每日的模型历史。

没有禁用计量的开关。数据跨账户汇总，因此只有管理员可查看。

页面报告调用、单位、令牌、延迟和结果。需要生效日期费率、支出明细、预算、警报或 会计导出时，添加成本治理。没有匹配费率或报告用量的事件会明确 显示为未定价，而不是免费。

OpenRouter 归因​

自 0.18.0 起，发往 OpenRouter 的请求通过应用归因标头识别应用 （HTTP-Referer: https://librewebui.org、应用标题和类别提示）。仅在请求发往 https://openrouter.ai 本身时发送，绝不发送到自定义或自托管路由，也不改变本地 存储内容。

相关文档​