Systemdiagnostik och användningsanalys

Libre WebUI ger administratörer två aktuella vyer över instansen: en sida för System med värd- och körtidsdiagnostik och en sida för Usage med analys av modell- och leverantörsanvändning. Båda är begränsade till administratörer i backend och gränssnittet. Läsning av sidorna stannar inom installationen. Valfri extern telemetri är en separat, operatörskonfigurerad väg för observerbarhet.

Öppna dem från administratörsposterna i sidofältet, flikmenyns administratörsgenvägar eller direkt på /system och /usage. Icke-administratörer kan inte öppna någon av sidorna, och administratörsflikarna stängs om ett inloggat konto förlorar rollen admin.

Systemdiagnostik

Systemsidan (/system) visar:

Värd: värdnamn, plattform, kärnversion, arkitektur, drifttid, antal logiska processorer, processormodell, belastningsmedelvärde och om processen verkar vara containeriserad. Ingen procentsats för processoranvändning visas; CPU-belastning är endast belastningsmedelvärdet.
Körtid: programversion, Node.js-version, process-ID, processens drifttid och arbetskatalog.
Minne: värdens totala, lediga och använda minne samt processens RSS- och heapvärden.
Filsystem: kapacitet och användning för körtidens filsystem (/) och datakatalogen (DATA_DIR).
Nätverk: gränssnittsnamn och adresser, med räknare för mottagna/skickade byte på Linux.
Docker: motorversion, värd-OS, kärna, CPU och minne som motorn rapporterar, samt containerantal och en reducerad containerlista när Docker-socketen är tillgänglig.

Sidan uppdateras var 30:e sekund när dess flik har fokus och har en manuell uppdateringsknapp. Backendslutpunkten är GET /api/system, skyddad av autentisering, en aktiv administratörsroll och en hastighetsgräns per användare på 120 förfrågningar per 15 minuter. Svar cachas aldrig (Cache-Control: no-store), och varje förfrågan samlar in nya värden.

Beroende av Docker-socket

Docker-avsnittet väljer sin slutpunkt på samma sätt som Work-körtiden och den interaktiva terminalen: WORK_DOCKER_SOCKET när den är angiven (alltid en lokal Unix-socketsökväg), annars DOCKER_HOST — en unix://-URL eller en vanlig tcp://-slutpunkt över HTTP, till exempel en filtrerad Docker API-proxy — och annars /var/run/docker.sock. Slutpunkter med ssh:// och npipe://, samt tcp:// med TLS-verifiering aktiverad, frågas avsiktligt inte. Förfrågningarna är strikt skrivskyddade GET-anrop till Docker-motorn (version, information, containerlista), har fyra sekunders timeout och begränsad svarsstorlek. Containerlistan begränsas till 100 poster.

Utan en användbar socket fungerar resten av sidan fortfarande. Docker-panelen rapporterar varför den inte är tillgänglig — socketen är inte monterad, är monterad men oläsbar, demonen kan inte nås eller slutpunkten är fjärransluten — i stället för att hela förfrågan misslyckas.

Vad sidan visar och för vem

Containerlistan är avsiktligt reducerad: kort ID, namn, avbildning, tillstånd och skapandetid. Miljövariabler, etiketter, monteringar, containerkommandon och inspektionsdata ingår aldrig, och inga uppgifter visas någonstans i svaret.

Sidan visar ändå verkliga infrastrukturdetaljer — värdnamn, arbetskatalog, interna IP-adresser samt namn och avbildningar för alla containrar på Docker-värden, inte bara Libre WebUI:s. Det överensstämmer med tillitsmodellen: i en Docker-installation är varje Libre WebUI-administratör redan i praktiken värdadministratör (se Docker). Tilldela rollen admin därefter.

Användningsanalys

Sidan Usage (/usage) visar diagram över modell- och leverantörsarbete som kan hänföras till användare. Mätning sker vid varje exekveringsgräns som stöds och omfattar för närvarande:

lokala Ollama-chattanrop, inklusive inbyggd Chat och Ollama-baserade Work-anrop;
chattanrop via installerad agent-CLI;
pluginbaserad chatt, både strömmad och icke-strömmad;
plugininbäddningar, bildgenerering, tal-till-text, text-till-tal, ljud och video; samt
pluginbaserade Work-anrop.

Bakgrundsåtgärder utan en ägande användare tilldelas avsiktligt inte ett syntetiskt konto och mäts därför inte. Ett anrop registreras fortfarande när det misslyckas eller avbryts.

Varje händelse registrerar:

leverantörs-/plugin-ID och en ögonblicksbild av visningsnamnet (ollama och agent-cli:* använder samma liggare som pluginleverantörer)
funktion (chat, embedding, image, stt, tts, audio, video)
modell
status: success, error eller cancelled (en avbruten ström räknas som avbruten)
antal token, endast när leverantören returnerade användningsmetadata
enhetsräknare som passar funktionen (tecken för TTS, bilder, inbäddningsindata, jobb för video och byte för ljud)
total varaktighet och en tidsstämpel
den begärande användarens ID

Inget annat lagras. Promptar, svar, leverantörsslutpunkter, uppgifter och leverantörernas felkroppar skrivs aldrig till användningstabellen — ett misslyckat anrop registreras endast som status = 'error'. Händelserna finns i den valda programdatabasen (SQLite i sololäge, PostgreSQL i teamläge) och sparas i 400 dagar. Äldre rader rensas opportunistiskt vid skrivning, högst en gång per dag. Mätningen görs avsiktligt utan leveransgaranti och kan aldrig få en modell- eller leverantörsförfrågan att misslyckas.

Sidan erbjuder intervall på 7, 30 och 90 dagar via en enda slutpunkt endast för administratörer, GET /api/plugins/usage?days=<1..365> (standard 30). Den visar totalt antal anrop, rapporterade token, framgångsgrad och genomsnittlig latens, ett dagligt diagram som kan växla mellan anrop och token, en tabell per modell, trafikandelar per plugin och funktionsfördelningen. Tokensummor innehåller endast anrop där leverantören rapporterade användningsmetadata.

Det finns ingen knapp för att inaktivera mätningen. Eftersom data sammanställs över flera konton är granskningen begränsad till administratörer.

Sidan Usage rapporterar anrop, enheter, token, latens och utfall. Lägg till kostnadsstyrning när dessa händelser behöver tidsbestämda tariffer, kostnadsuppdelningar, budgetar, varningar eller bokföringsexport. Händelser utan en matchande tariff eller leverantörsrapporterad användning visas som ej prissatta i stället för att behandlas som kostnadsfria.

OpenRouter-attribution

Sedan 0.18.0 identifierar förfrågningar till OpenRouter programmet genom OpenRouters rubriker för appattribution (HTTP-Referer: https://librewebui.org, en programtitel och kategoriledtrådar). Dessa rubriker skickas endast när förfrågan går till https://openrouter.ai självt — aldrig till en anpassad eller självhostad rutt — och lägger inte till något i det som lagras lokalt.