Спостережуваність
Є два шляхи: структуровані локальні журнали stdout/stderr і необов’язковий експортер OpenTelemetry для HTTP, довговічних завдань, лічильників та попереджень/помилок. Нічого не надсилається проєкту Libre WebUI; OpenTelemetry вимкнено без кінцевої точки. Система й використання описані окремо.
Структуровані журнали
LOG_FORMAT=text — звичайний, LOG_FORMAT=json — JSON на рядок:
LOG_LEVEL=info
LOG_FORMAT=json
Час ISO, рівень/область, повідомлення, ID кореляції запиту/завдання й обмежені деталі. Кожен HTTP-запит має X-Request-Id; приймаються 8–64 літери, цифри, ., _, -, інакше використовується UUID. Рядок запиту вилучається.
LOG_LEVEL: silent, error, warn, info, debug. Debug захищайте як дані.
Межа редагування
Поля, схожі на пароль, секрет, токен, ключ, авторизацію, cookie, облікові дані, bearer або JWT, вилучаються; рядки обмежено 512 символами; масиви, глибина й атрибути також обмежені; помилка залишає ім’я й коротке повідомлення. Це багаторівневий захист, а не дозвіл журналювати промпти. Журналюйте ID та результати, обмежуйте доступ і строк зберігання.
OpenTelemetry
OTEL_EXPORTER_OTLP_ENDPOINT=https://otel-collector.example.com:4318
OTEL_EXPORTER_OTLP_HEADERS=authorization=Bearer example-collector-token
OTEL_SERVICE_NAME=libre-webui
До URL додаються /v1/traces, /v1/metrics, /v1/logs. OTEL_EXPORTER_OTLP_HEADERS — розділений комами список key=value. Секрети зберігайте як секрети розгортання. OTEL_SERVICE_NAME типово має значення libre-webui.
Без endpoint усе no-op. У team app і worker експортують окремо.
Сигнали
Охоплення й лічильники HTTP, охоплення й лічильники довговічних завдань, а також відредаговані записи попереджень/помилок з ID кореляції. Немає поширення батьківського трасування, міжсервісних дерев або повного інструментування браузера й постачальника. Використання токенів і медіа відображається в локальних аналітиці та витратах.
Доставка
Максимум 2 048 охоплень і записів, 512 рядів; скидання приблизно кожні 5 с; тайм-аут 3 с; помилка відкидає пакет і не ламає запит. Це не аудит і не облік.
Неполадки
Перевірте OTEL_EXPORTER_OTLP_ENDPOINT, три стандартні шляхи й authorization=Bearer .... Після зміни env перезапустіть. Запити працюють при падінні колектора навмисно. Відсутні/скорочені поля спричинені редагуванням.