Диагностика системы и аналитика использования

Libre WebUI даёт администраторам Систему с диагностикой хоста и среды выполнения и Использование с аналитикой моделей/провайдеров. Обе ограничены в сервере и интерфейсе. Чтение остаётся внутри; внешняя телеметрия — отдельная Наблюдаемость оператора.

Открывайте с панели, меню или /system, /usage. Неадминистратор не может, а вкладка закрывается при потере admin.

Диагностика системы

/system показывает:

Хост: имя, платформа, ядро, архитектура, время работы, логические CPU, модель, средняя нагрузка и контейнеризация. Процента загрузки CPU нет, показывается только средняя нагрузка.
Среда выполнения: версии приложения и Node.js, PID, время работы и рабочий каталог.
Память: всего/свободно/занято, RSS процесса и куча.
Файловые системы: / и DATA_DIR.
Сеть: интерфейсы/адреса, Linux-байты.
Docker: версия, ОС, ядро, CPU, память, числа и сокращённый список при доступном сокете.

Обновление каждые 30 секунд при фокусе и вручную. GET /api/system требует аутентификацию, активного администратора и 120 запросов на 15 минут на пользователя. Ответы Cache-Control: no-store, всегда свежие.

Зависимость от сокета Docker

Выбор выполняется как в Work и терминале: WORK_DOCKER_SOCKET (локальный Unix), иначе DOCKER_HOST — unix:// или простой HTTP tcp:// (прокси), затем /var/run/docker.sock. ssh://, npipe://, tcp:// с проверкой TLS не запрашиваются. Выполняются только запросы GET версии, информации и списка, с тайм-аутом 4 секунды, ограниченным ответом и максимум 100 контейнерами.

Без сокета остальная страница работает и объясняет причину: не смонтирован, недоступен для чтения, демон недостижим или используется удалённая конечная точка.

Что раскрывается и кому

Список: короткий ID, имя, образ, состояние, время. Переменные окружения, метки, точки монтирования, команды контейнера, данные inspect и учётные данные никогда не включаются.

Но видны реальные имя хоста, каталог, внутренние IP и все контейнеры, не только Libre. Это соответствует доверию: администратор Libre в Docker фактически администратор хоста (см. Docker).

Аналитика использования

Учёт на пользователя охватывает:

локальные вызовы чата Ollama и Work;
установленные агенты CLI и вызовы движка Strands;
чат через плагины со streaming и без него;
эмбеддинги, изображения, распознавание и синтез речи, аудио и видео через плагины; и
Work через плагины.

Фоновое без владельца не присваивается синтетическому аккаунту. Ошибка/отмена записывается.

Событие хранит:

ID и снимок имени (ollama и agent-cli:* в том же реестре, что и провайдеры плагинов)
возможность (chat, embedding, image, stt, tts, audio, video)
модель
success, error, cancelled (прерванный поток — cancelled)
токены только от провайдера
единицы: символы TTS, изображения, входы эмбеддингов, задания видео и байты аудио
длительность и временная метка
ID пользователя

Ничего другого. Промпты, ответы, точки провайдеров, учётные данные и тела ошибок никогда не пишутся — только status = 'error'. События в SQLite solo или PostgreSQL team хранятся 400 дней, старые удаляются при записи не чаще раза в день. Учёт выполняется по принципу максимальных усилий и не ломает запрос.

Диапазоны 7, 30, 90 дней через GET /api/plugins/usage?days=<1..365> (по умолчанию 30) и только для администратора. Показывает число вызовов, зарегистрированные токены, долю успеха, среднюю задержку и долю вызовов, сообщивших о расходе токенов. Просмотр страницы ничего не изменяет и использует уже существующий журнал использования.

Использование агентов

Раздел Агенты вверху (Вызовы CLI-агентов и движка Strands) отдельно показывает Claude Code, Codex, OpenCode, Pi и Strands: вызовы, сообщённые токены, неудачные или отменённые вызовы, среднюю длительность и до 20 наиболее используемых моделей каждого агента. Итоги охватывают все подходящие вызовы выбранного периода независимо от ограничений отображения общих таблиц провайдеров и моделей. Это части общих итогов страницы, а не дополнительные оплачиваемые события.

У агента без записей указано В этом периоде нет зарегистрированных вызовов. Это не говорит, установлена ли CLI и выполнен ли вход. Вызовы без метаданных токенов помечены Токены не указаны; недостающие счётчики не оцениваются. Видимая страница обновляется каждые 20 секунд, доступно и ручное обновление.

Учёт CLI записывает один запуск и сообщённые CLI счётчики токенов. Накопительные снимки заменяют предыдущие; повторные отчёты шагов удаляются как дубликаты. Счётчики кеша и рассуждений объединяются согласно протоколу каждой CLI без двойного учёта подмножеств. Отменённые вызовы и частичные ответы с неуспешным завершением сохраняют фактический результат.

Вызовы Strands относятся к агенту Strands. У движка нет собственного провайдера моделей; каждый его вызов модели проходит через провайдеров Ollama или плагинов Libre WebUI. Вызовы вне LWUI не импортируются. Старые записи без счётчиков токенов остаются неизмеренными.

Конечная точка возвращает это ограниченное разбиение в agents, включая все пять поддерживаемых имён даже при нулевых счётчиках. Чтение не обнаруживает модели CLI, не запускает агентов и не обращается к провайдерам. Старые серверы без поля могут показывать зарегистрированные записи агентов из разбивки по провайдерам; отсутствующие записи там не считаются подтверждённым нулевым использованием.

Изучение моделей и поставщиков

Цвета моделей связывают дневной график, годовой календарь активности, таблицу моделей и полосы поставщиков. Рядом с цветами показаны имена моделей, значения и индикаторы выбора. Календарь активности всегда охватывает последние 365 дней независимо от выбранного диапазона; цвет дня указывает самую используемую модель.

Дневной график переключается между Вызовы и Токены. Наведите указатель на модель в легенде или переведите на неё фокус клавиатуры, чтобы проследить её линию. Выберите модель, чтобы удержать выделение, выберите повторно, чтобы снять его, или нажмите Показать все модели для сброса. В таблице моделей тоже есть действие выделения. Выделение меняет только акцент и сохраняет дневные суммы, значения таблицы и суммы поставщиков.

Проведите указателем по графику или воспользуйтесь пунктом Изучить ежедневное использование, чтобы посмотреть сумму дня и разбивку по моделям. Дневной ползунок работает с клавиатуры: стрелки перемещают между днями, Home/End переводят к первому и последнему. Дневные интервалы и их подписи используют UTC.

По умолчанию график показывает 12 имён моделей с наибольшим числом вызовов за выбранный период, в том числе в режиме токенов. Любую модель можно рассмотреть отдельно: наведите фокус или выберите модель в таблице либо в сведениях поставщика, чтобы загрузить её точную дневную линию, даже если она вне этой дюжины. Сообщение о загрузке называет запрошенную модель, пока извлекается её история.

Линия дополнительной модели отделяется от группы Другие модели, и оставшаяся группа не включает её вызовы, зарегистрированные токены и ошибки. График содержит не более 13 именованных линий моделей плюс оставшуюся группу, а их дневные значения по-прежнему сходятся с теми же итогами. Нажмите Показать все модели, чтобы вернуться к виду по умолчанию.

Дневные линии объединяют вызовы с одинаковым записанным именем модели у разных поставщиков. Таблица моделей сохраняет отдельные записи «поставщик/модель», поэтому одна модель может встречаться у нескольких поставщиков. Именованные модели сохраняют собственные цвета в таблице и полосах поставщиков, включая модели вне графика по умолчанию.

Сведения о поставщике показывают его долю запросов, полосу с разбивкой по моделям, зарегистрированные токены, неудавшиеся или отменённые вызовы и среднее время ответа. Состав возможностей остаётся доступным под разбивками по моделям и поставщикам.

Итоги по токенам включают только вызовы, для которых поставщик сообщил метаданные использования. Процент покрытия делает частичную отчётность видимой; недостающие токены никогда не оцениваются по запросам или по другой модели. Период без зарегистрированных токенов показывает пояснение в представлении «Токены», а история запросов остаётся доступной в представлении «Вызовы».

Конечная точка включает дневные точки моделей в modelSeries. Необязательный параметр запроса model запрашивает одно точное записанное имя модели вдобавок к стандартной дюжине, например 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, никогда пользовательские или самостоятельно размещённые маршруты, и не добавляют локальных данных.